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内 容 简 介 


本 书 是 一 部 讲解 Kotlin 语言 的 入 门 书籍 ， 从 Kotlin 语言 的 基本 语法 一 直 讲 到 如 何 将 其 运用 于 Android 开发 。 
由 浅 入 深 、 从 理论 到 实战 ， 帮 助 读者 快速 掌握 Kotlin 开发 技巧 。 

全 书 共有 10 章 内容 ， 可 分 为 三 大 部 分 : 第 一 部 分 即 第 1 章 ， 主 要 介绍 Kotlin 语言 的 开发 环境 搭建 ， 第 二 部 分 
包含 第 2~5 章 ， 主 要 介绍 Kotlin 的 基本 语法 知识 ， 包 括 Kotlin 的 变量 声明 、 控 制 语 铝 、 函 数 定义 、 类 与 对 象 等 ; 第 
三 部 分 包含 第 6~10 章 ， 主 要 介绍 如 何 使 用 Kotlin 进行 实际 的 App 开发 工作 ， 包 括 利 用 Kotlin 操作 简单 控件 、 复 杂 
控件 、 数 据 存储 、 自 定义 控件 、 网 络 通信 等 。 为 增强 学 习 Kotlin 语言 的 趣味 ， 本 书 在 讲解 Kotlin 的 用 法 时 ， 特 别 注 
意 结合 生活 中 的 具体 案例 ， 并 加 以 示范 和 运用 。 尤 其 是 后 面 讲 到 利用 Kotlin 开发 App 的 时 候 ， 精 心 设计 了 数 个 电 商 
App 的 实战 模块 ， 例 如 电 商 App 的 登录 模块 、 频 道 模 块 、 购 物 车 模块 、 团 购 模 块 、 升 级 模块 等 。 通 过 这 些 实战 小 项 目 ， 
读者 可 迅速 将 Kotlin 应 用 于 App 开发 工作 中 。 

本 书 适 用 于 Android 开发 的 广大 从 业者 、Kotlin 语言 的 业余 爱好 者 ， 也 可 用 作 大 中 专 院 校 与 培训 机 构 的 Kotlin 
课程 教材 。 
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了 路 


前 


新 技术 的 发 展 日 新 月 异 ， 编 程 语言 也 不 例外 ， 从 早期 的 机 器 语言 到 汇编 语言 ， 再 到 以 C 
语言 为 代表 的 高 级 语言 ， 一 路 衍生 了 C++、Java、Objective-C 等 庞大 的 编程 语言 家 族 。 其 中 ， 
Java 经 过 多 年 的 发 展 已 经 是 一 枝 独 秀 ， 不 但 在 服务 端的 开发 中 占据 优势 ， 而 且 在 客户 端的 安 
卓 开发 上 也 形成 垄断 之 势 。 不 过 ， 由 于 Java 语言 诞生 较 早 〈 诞 生 于 20 世纪 90 年 代 中 期 ) ， 
使 得 它 不 可 避免 地 存在 一 些 先天 不 足 ， 比 如 业务 代码 过 于 元 长 、 处 理 逻 辑 不 够 灵活 、 安 全 隐患 
层出不穷 等 。 鉴 于 此 ， 一 方面 Java 语言 不 断 更 新 换代 ， 到 2017 年 已 经 迭代 到 了 Java 9 版 本 ; 
另 一 方面 ， 人 们 也 试图 设计 新 的 语言 以 便 更 好 地 “ 填 坑 ”,， 于 是 涌现 了 Scala、Groovy、Clojure 
等 新 兴 语 言 ， 而 Kotlin 就 是 这 些 新 兴 语 言 中 的 佼佼 者 。 


Kotlin 问世 于 2011 年 ， 作 为 后 起 之 秀 的 它 虽 然 拥有 代码 简洁 、 函 数 式 编程 、 更 安全 健壮 、 
百 分 百 兼容 Java 等 诸多 特性 ， 但 是 前 有 C++、jJava 等 老 语 言 根深 叶 茂 ， 后 有 Python 、Go 等 新 
语言 紧 追 不 舍 ，Kotlin 头 几 年 的 发 展 一 直 不 温 不 火 。 直 到 这 两 年 , 在 JetBrains、Google 等 公司 
的 大 力 扶持 之 下 ，Kotlin 的 发 展 才 驶 上 了 快车 道 ， 先 是 在 2016 年 2 月 推出 Kotlin 1.0 发 布 版 ， 
再 是 谷歌 公司 在 2017 年 5 月 宣布 将 Kotlin 作为 Android 的 官方 开发 语言 ， 然 后 在 2017 年 10 
月 推出 的 Android Studio 3.0 正式 集成 了 Kotlin 开发 环境 , 紧 接着 更 完善 的 Kotlin 1.2 正式 版 在 
2017 年 11 月 发 布 。 正 如 当初 Android Studio 取代 Eclipse 成 为 Android 开发 的 主流 开发 工具 一 
样 ， 在 可 预见 的 未 来 ，Kotlin 必 将 逐步 取代 Java 成 为 主流 的 App 开发 语言 。 


被 寄予 厚望 的 Kotlin 在 编程 工作 中 给 开发 者 带 来 的 巨大 便利 毋庸 置疑 ， 大 量 的 开发 实践 
表明 ， 实 现 同样 功能 的 Kotlin 代码 往往 只 有 对 应 Java 代码 的 三 分 之 一 。 并 且 Kotlin 的 语法 兼 
容 并 营 、 易 懂 易 学 ， 只 要 开发 者 拥有 任何 一 门 高 级 语言 的 编程 基础 ， 再 配合 一 本 合适 的 Kotlin 
入 门 教程 ， 短 时 间 内 即 可 成 为 Kotlin 熟练 开发 者 。 正 因为 Kotlin 是 如 此 的 简单 易 用 ， 它 的 代 
码 也 是 如 此 的 简洁 明了 ， 所 以 倘若 介绍 Kotlin 语法 的 教程 还 在 长 篇 大 论 ， 那 它 一 定 是 在 夸大 
其 谈 地 “页 流 谍 ”。Kotlin 的 设计 理念 是 尽 可 能 的 简易 ， 而 不 是 抛 出 一 堆 令 人 生 由 的 烦琐 概念 ， 
因此 本 书 在 介绍 Kotlin 用 法 的 时 候 ， 也 秉承 了 与 之 相符 的 一 贯 理 念 ， 即 凡是 能 够 简单 处 理 的 
事情 ， 决 不 拐弯 抹 角 、 拖 泥 带 水 。 


本 书 既 是 一 本 Kotlin 语法 的 入 门 教程 ,也 是 讲述 Kotlin 开发 App 的 教程 ,一 方面 介绍 Kotlin 
语言 的 基本 语法 ， 另 一 方面 介绍 Kotlin 在 安 卓 开发 中 的 实际 应 用 ， 可 谓 是 结合 理论 、 联 系 实 
战 ， 方 便 读 者 迅速 将 Kotlin 运用 于 日 常 的 App 开发 工作 之 中 ， 更 好 、 更 快 地 将 学 习 成 果 展 现 
出 来 ， 起 到 立竿见影 的 工作 成 效 。 当 然 ， 本 书 的 侧重 点 在 于 教会 读者 利用 Kotlin 进行 安 卓 开 
发 工作 ， 故 而 在 有 限 的 内 容 篇 幅 上 有 所 取舍 ， 比 如 服务 端的 Kotlin 开发 着 墨 不 多 ， 另 外 阐述 
了 如 何 使 用 Kotlin 实现 常见 的 几 种 App 开发 技术 ， 其 余 的 App 开发 涉及 的 Kotlin 技术 即 可 触 
类 旁 通 。 如 果 读 者 想 要 了 解 更 详细 、 更 具体 的 App 开发 技能 ， 可 参见 笔者 的 另 一 部 App 开发 
专著 《Android Studio 开发 实战 : 从 零 基础 到 App 上 线 》。 




















全 书 共有 10 章 内 容 ， 循 序 渐进 ， 可 分 为 三 大 部 分 : 第 一 部 分 即 第 1 章 ， 主 要 介绍 Kotlin 
语言 的 开发 环境 搭建 ; 第 二 部 分 包含 第 2~5 章 ， 主 要 介绍 Kotlin 的 基本 语法 知识 ,包括 Kotlin 
的 变量 声明 、 控 制 语句 、 函 数 定义 、 类 与 对 象 等 ， 第 三 部 分 包含 第 6~10 章 ， 主 要 介绍 如 何 使 
用 Kotlin 进行 实际 的 App 开发 工作 ， 包 括 如 何 通过 Kotlin 使 用 简单 控件 、 如 何 通过 Kotlin 操 
纵 复 杂 控件 、 如 何 通过 Kotlin 进行 数据 存储 、 如 何 通过 Kotlin 自 定 义 控件 、 如 何 通过 Kotlin 
实现 网 络 通信 等 。 通 过 本 书 这 10 章 的 学 习 ， 读 者 应 该 能 够 掌握 Kotlin 的 大 部 分 常用 语法 ， 并 
将 其 得 心 应 手 地 运用 于 App 开发 工作 中 ， 你 会 发 现 多 了 一 门 可 供 选择 的 App 开发 语言 是 多 么 
奇妙 的 事情 。 


从 零 开 始 学 Kotlin 其 实 指 的 是 Kotlin 零 基础 ， 并 非 编程 零 基础 。 在 学 习 本 书 之 前 ， 读 者 
应 当 掌 握 至 少 一 门 高 级 开发 语言 。 如 果 没 有 任何 编程 基础 就 来 学 习 Kotlin, 这 是 不 现实 也 是 不 
可 取 的 , 因为 短期 之 内 各 公司 不 会 招聘 只 会 Kotlin 的 程序 员 , 而 且 Kotlin 在 Android 开发 中 取 
代 Java 也 必然 是 个 缓慢 的 进程 。 所 以 学 习 Kotlin 不 提倡 急于 求 成 ， 但 这 并 不 意味 着 App 开发 
者 可 以 对 Kotlin 熟视无睹 ， 任 何 一 个 新 事物 都 有 其 发 展 壮大 的 过 程 ， 同 时 机 会 都 是 留 给 有 准 
备 的 人 。 与 其 等 Kotlin 形成 煤 原 之 势 才 后 知 后 觉 地 学 习 它 ， 不 如 现在 就 未 雨 绸 绪 地 掌握 它 ， 
技术 投资 得 越 早 ， 未 来 的 开发 收益 就 越 大 。 


本 书 的 所 有 代码 例子 都 基于 Android Studio 3.0 和 Kotlin 1.2 开发 ， 并 使 用 API27 的 SDK 
(Android 8.1) 编译 与 调试 通过 。 所 有 的 附录 源 代码 均 可 在 网 络 上 下 载 ， 具 体 下 载 方式 可 访问 
笔者 的 博客 http://blog.csdn.net/aqi00。 读 者 也 可 以 从 以 下 地 址 下 载 本 书 源 代码 : 


https://pan.baidu.com/s/1ceRZzDK4_zT-uQHqy2WFHw (注意 区 分 数字 和 英文 字 
母 大 小 写 ) 

如 果 下 载 有 问题 ， 请 发 送 电子 邮件 至 booksaga@126.com， 邮 件 标题 为 “Kotlin 从 零 
到 精通 Android 开发 配 书 源 代 码 ” 获 得 帮助 。 

读者 在 阅读 本 书 时 ， 若 对 书 中 内 容 有 疑问 , 也 可 在 该 博客 上 留言 。 或 者 关注 笔者 的 微 信 公 
众 号 “ 老 欧 说 安 卓 ”， 更 快 更 方便 地 阅读 技术 干货 。 

最 后 感谢 王 金 柱 编辑 以 及 各 位 出 版 社 同仁 的 热情 指点 和 密切 配合 , 感谢 我 的 家 人 一 直 以 来 
的 支持 ， 如 果 没 有 大 家 的 易 力 协助 ， 就 没有 本 书 的 顺利 完成 。 


欧阳 系 
2018 年 1 月 
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搭建 Kotlin 开发 环境 


本 章 主 要 介绍 Kotlin 开发 环境 的 搭建 过 程 ， 首 先 阐述 Kotlin 语言 与 Android 开发 之 间 的 关系 ， 
接着 描述 Kotlin 开发 工具 ， 也 就 是 Android Studio 的 安装 和 启动 步骤 ， 然 后 说 明 SDK 及 其 相关 插 
件 的 安装 与 升级 方法 ， 接 着 论述 如 何 对 Kotlin 工程 的 编译 配置 进行 调整 ， 最 后 演示 Kotlin 新 技术 
带 来 哪些 革命 性 的 变化 。 


1.1 Kotlin 与 Android 开发 的 关系 





本 节 主 要 介绍 Kotlin 语言 与 Android 开发 之 间 的 关系 ， 包 括 Kotlin 的 基本 概念 及 其 特殊 优势 ， 
以 及 Kotlin 被 谷歌 钦定 为 Android Studio 官方 开发 语言 之 后 的 发 展 大 事 。 


1.1.1 ”Kotlin 语言 简介 


Kotlin 是 一 种 基于 JVM 的 新 型 编程 语言 ， 它 完全 兼容 Java 语言 ，Kotlin 代码 可 以 编译 成 Java 
字 节 码 , 也 可 以 编译 成 JavaScript, 方便 在 没有 JVM 的 设备 上 运行 。 与 流行 的 Java 语言 比较 , Kotlin 
具备 下 列 优 势 : 
(1) Kotlin 更 简洁 ， 完 成 同样 的 业务 功能 ，Kotlin 代码 通常 只 有 对 应 Java 代码 的 三 分 之 一 。 
(2) Kotlin 更 安全 ， 它 能 够 在 编码 阶段 就 自动 检测 常见 的 BUG， 比 如 引用 了 空 指针 等 。 
(3) Kotlin 更 强大 ， 它 提供 了 扩展 函数 、 默 认 参 数 、 接 口 委托 、 属 性 代理 等 Java 所 不 具备 的 
高 级 特性 ， 从 而 可 以 完成 更 复杂 的 业务 逻辑 。 
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1.1.2 ”Android Studio 的 官方 开发 语言 


Kotlin 很 早 就 被 运用 到 Android 开发 之 中 ， 之 前 一 直 作为 Android Studio 的 插件 提供 下 载 ， 
Android Studio 只 要 安装 了 Kotlin 插件 ， 就 能 用 来 开发 Kotlin 编码 的 App 工程 。 

2017 年 5 月 ,谷歌 宣布 将 Kotlin 纳入 Android Studio 开发 的 官方 语言 , 这 意味 着 Android Studio 
对 Kotlin 的 编译 支持 会 大 大 增强 ， 由 此 掀起 了 广大 安 卓 开发 者 学 习 Kotlin 编程 的 热潮 。 

2017 年 10 月 ,Android Studio 推出 3.0 正式 版 ,从 3.0 版 本 开始 ,Android Studio 自动 集成 Kotlin 
插件 ， 在 安装 Android Studio 3.0 时 就 连带 配置 了 Kotlin 的 开发 环境 。 

2017 年 11 月 ，Kotlin 语言 推出 1.2 发 布 版 ， 该 版 本 的 Kotlin 具备 更 好 的 跨 平 台 特 性 ， 编 译 性 
能 也 比 1.1 版 提高 了 25% 左 右 ， 同 时 也 更 好 地 支持 Android 开发 。 


1.2 ”Kotlin 开发 工具 


本 节 主 要 介绍 Kotlin 开发 环境 的 搭建 以 及 Kotlin 工程 的 基本 操作 ， 包 括 安装 Android Studio 
的 具体 步骤 、 启 动 Android Studio 的 详细 配置 、 如 何 创建 一 个 Kotlin 工程 、 如 何 新 建 各 种 Kotlin 文 
件 等 。 





1.2.1 安装 Android Studio 


Android Studio 的 官方 下 载 页 面 是 https://developer.android.google.cn/studio/index.html， 在 这 里 
可 以 找到 Android Studio 的 下 载 地 址 与 使 用 教程 。 首 先 把 最 新 版 本 的 Android Studio 下 载 到 电脑 本 
地 ， 然 后 双击 下 载 完 成 的 Android Studio 安装 程序 ， 弹 出 安装 欢迎 对 话 框 ， 如 图 1-1 所 示 。 单 击 该 
对 话 框 右 下方 的 “Next” 按 钮 ， 跳 到 下 一 页 的 许可 同意 对 话 框 ， 单 击 “Agree” 按 钮 ， 进 入 下 一 页 
的 组 件 选择 对 话 框 ， 如 图 1-2 所 示 。 


[TC EE 


Choose Compononts 
CChoose whic features of Arcrad Studio you want to nstal 


Chedk the components you want to instal and uncheck the components you do't want to 
nstal, Chdk Next to continue. 


it is reconmendad hat you doss al oher appcatione 
before tarting Setup. The wil make it posside th update 


fles withouthavng to reboct your Select conponerts io nstal: 





图 1-1 Android Studio 的 安装 欢迎 对 话 框 1-2 Android Studio 的 组 件 选择 对 话 框 
全 部 勾 选 ， 然 后 单 击 “Next” 按 钮 ， 跳 转 到 安装 路 径 配 置 对 话 框 。 建 议 将 Android Studio 安装 
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在 除 系统 盘 外 的 其 他 磁盘 ， 比 如 D 盘 ， 如 图 1-3 所 示 ， 然 后 单 击 “Next” 按 钮 。 在 下 一 个 对 话 框 中 
选择 开始 菜单 的 目录 ， 这 里 使 用 默认 的 “Android Studio”， 如 图 1-4 所 示 ， 然 后 单 击 “Install” 按 
钮 ， 等 待 安装 过 程 进行 。 
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图 1-3 Android Studio 的 安装 目录 对 话 框 1-4 Android Studio 的 安装 设置 对 话 框 


安装 过 程 的 进度 对 话 框 如 图 1-5 所 示 ， 进 度 完成 的 结果 对 话 框 如 图 1-6 所 示 ， 单 击 “Next” 按 
结束 安装 操作 。 


Android Studio Set 
aling 
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证 
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图 1-5 Android Studio 的 安装 进度 对 话 框 


安装 完毕 后 弹出 一 个 提示 对 话 框 ， 如 图 1-7 所 TS 
示 ， 上 面 默 认 勾 选 了 “Start Android Studio”, 单 | Completing Android Studio Setup 
击 右 下 角 的 “Finish” 按 钮 即 可 启动 Android Studio。 


Android Studio has beeninstaled on your computer. 


Cick Finish to cose sc 


ert Android Studd 








1-7 Android Studio 的 安装 完成 对 话 框 
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1.2.2 ”启动 Android Studio 


首次 安装 Android Studio 3.0 会 弹出 一 个 提示 对 话 框 ， 如 图 1-8 所 示 ， 在 此 开发 者 可 以 选择 从 
哪个 目录 导入 之 前 的 Android Studio 设置 。 为 了 更 好 地 演示 完整 的 启动 过 程 ， 这 里 选择 最 下 面 的 选 
项 “Do not import settings”， 表 示 不 导入 任何 已 有 设置 ， 完 全 重新 开始 进行 设置 。 

选 好 之 后 ， 单 击 提示 对 话 框 下 方 的 “OK” 
按钮 , Android Studio 便 执 行 启动 操作 , 如 图 1-9 
所 示 。 





ouyangshen\ AndroidStudio? 3 


Eolder or installation hone of the previons varsion 





1-8 Android Studio 首次 安装 后 的 设置 导入 提示 对 话 框 ”图 1-9 Android Studio 正在 启动 的 提示 对 话 框 


因为 前 面 选 定 了 不 导入 任何 设置 重新 开始 ,所 以 Android Studio 将 不 会 导入 任何 工程 ， 而 是 弹 
出 一 个 向 导 对 话 框 ， 提 示 开 发 者 去 进行 新 的 设置 ， 如 图 1-10 所 示 。 单 击 “Next” 按 钮 ， 进 入 下 一 
页 的 安装 类 型 对 话 框 ， 如 图 1-11 所 示 。 

这 里 保持 “Standard” 选 项 ， 单 击 “Next” 按 钮 ， 进 入 下 一 个 对 话 框 ， 如 图 1-12 所 示 。 继 续 单 
击 “Next” 按 钮 ， 进 入 向 导 的 确认 对 话 框 ， 如 图 1-13 所 示 。 在 该 对 话 框 确认 SDK 的 安装 路 径 是 否 
正确 ， 确 认 完毕 单 击 “Finish” 按 钮 ， 等 待 后 续 的 SDK 下 载 操作 。 

接 下 来 的 下 载 对 话 框 会 自动 到 谷歌 网 站 更 新 组 件 ， 如 图 1-14 所 示 。 如 果 电 脑 本 地 没有 SDK， 
就 继续 等 待 下 载 更 新 ， 如 果 电 脑 本 地 已 有 现成 的 SDK， 就 直接 单 击 “Cancel” 按 钮 取消 下 载 ， 然 
后 单 击 “Finish” 按 钮 结束 设置 。 最 后 弹出 一 个 “Welcome to Android Studio” 欢 迎 对 话 框 ， 如 图 
1-15 所 示 。 单 击 第 一 项 的 “Start a new Android Studio project” 即 可 开始 你 的 Android 开发 之 旅 。 


i ~ 一 








图 1-10 Android Studio 的 启动 向 导 对 话 框 1 图 1-11 Android Studio 的 启动 向 导 对 话 框 2 
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图 1-14 Android Studio 的 启动 向 导 对 话 框 5 图 1-15 Android Studio 的 启动 欢迎 对 话 框 


1.2.3 ”创建 Kotlin 工程 


1.2.2 小 节 提 到 Android Studio 启动 设置 完成 之 后 ， 会 弹出 欢迎 对 话 框 提示 创建 新 的 Android 工 
程 ， 此 时 单 击 第 一 项 的 “Start a new Android Studio project” 打 开工 程 创建 对 话 框 ， 如 图 1-16 所 示 。 





图 1-16 Android Studio 的 工程 创建 对 话 框 
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在 工程 创建 对 话 框 中 填写 应 用 名 称 “Application name” 以 及 公司 域名 “Company domain”， 
并 选择 或 填写 Android 工程 的 本 地 保存 路 径 “Project location”。 注 意 ， 创 建 页 面 下 方 有 两 个 选项 
“Include C++ support” 和 “Include Kotlin support”， 其 中 色 选 “Include C++ support” 表 示 要 进行 
NDK/JNI 开发 ， 但 这 不 是 本 书 的 讲解 范围 ， 因 此 不 必 勾 选 该 复 选 框 ， 勾 选 “Include Kotlin support” 
则 表示 要 进行 Kotlin 开发 ， 因 此 务必 人 勾 选 该 复 选 框 ， 才 能 继续 后 面 的 Kotlin 开发 学 习 。 确 认 对 话 
框 中 的 各 项 信息 都 填写 完毕 ， 单 击 下 方 的 “Next” 按 钮 ， 进 入 目标 设备 对 话 框 ， 如 图 1-17 所 示 。 
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图 1-17 Android Studio 创建 新 工程 时 的 目标 设备 对 话 框 
在 目标 设备 对 话 框 中 ，Android Studio 默认 色 选 了 “Phone and Tablet”， 表 示 进 行 手机 /平板 应 
用 开发 ， 下 面 的 API 最 低 支持 版 本 原本 默认 是 API 15， 不 过 因为 如 通知 的 新 特性 从 API 16 开始 才 
支持 ， 所 以 这 里 建议 把 最 低 版 本 改 为 API 16， 接 着 单 击 “Next” 按 钮 ， 进 入 初始 风格 对 话 框 ， 如 
图 1-18 所 示 。 





图 1-18 Android Studio 创建 新 工程 时 的 初始 风格 对 话 框 


在 初始 风格 对 话 框 中 选择 “Empty Activity”， 然 后 单 击 下方 的 “Next” 按 钮 ， 进 入 名 称 配置 
对 话 框 ， 如 图 1-19 所 示 。 
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图 1-19 Android Studio 创建 新 工程 时 的 名 称 配置 对 话 框 


在 名 称 配置 对 话 框 保持 默认 设置 , 即 活动 代码 名 称 “Activity Name ”仍然 填写 “MainActivity”， 
布局 文件 名 称 “Layout Name” 仍 然 填写 “activity_name”， 然 后 单 击 “Finish” 按 钮 ， 进 入 Android 
Studio 的 完整 开发 界面 ， 如 图 1-20 所 示 。 
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class Nainhetivity : AppConpathctivity() { 














图 1-20 Android Studio 创建 新 工程 之 后 的 开发 界面 


在 编写 代码 的 时 候 ，Android Studio 会 自动 编译 。 若 开发 者 想 手动 重新 编译 ， 则 有 以 下 三 种 编 
译 方式 : 

(1) 选择 菜单 “Build” 一 “Make Project”， 这 个 是 编译 整个 项 目下 的 所 有 模块 。 

(2) 选择 菜单 “Build” 一 “Make Module ***”， 这 个 是 编译 指定 名 称 的 模块 。 

(3) 选择 菜单 “Build” 一 “Clean Project”， 然 后 再 选择 菜单 “Build” 一 “Rebuild Project”， 
这 个 是 先 清理 项 目 ， 再 对 整个 项 目 重新 编译 。 

前 面 新 创建 的 工程 当然 不 会 出 现 编译 错误 ， 直 接 运行 就 好 了 。 先 把 手机 通过 数据 线 接 入 开发 
电脑 的 USB 上 ， 再 依次 选择 菜单 “Run” 一 “Run 'app'”， 弹 出 目标 设备 选择 对 话 框 ， 列 表 中 便 会 
显示 接 入 的 手机 设备 ， 如 图 1-21 所 示 。 

单 击 “OK” 按 钮 ， 执 行 测试 App 的 安装 操作 ， 不 出 意外 的 话 ， 一 会 儿 即 可 在 手机 上 看 到 测试 
应 用 的 启动 界面 ， 具 体 效果 如 图 1-22 所 示 。 
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1-21 运行 测试 应 用 时 弹出 的 目标 设备 选择 对 话 框 图 1-22 ”测试 应 用 的 启动 界面 


1.2.4 ”新建 Kotlin 文件 


上 一 小 节 创 建 Kotlin 工程 后 主要 生成 两 个 文件 , 一 个 是 Kotlin 代码 文件 MainActivity.kt， 另 一 
个 是 XML 布局 文件 activity_name.xml。 其 中 ，MainActivity.kt 就 是 扩展 名 为 kt 的 Kotlin 格式 的 代 
码 文件 ， 相 对 应 地 ，Java 代码 文件 的 扩展 名 为 java。 这 个 MainActivity.kt 是 在 创建 工程 时 自动 生成 
的 ， 那么 如 何在 已 有 工程 中 创建 新 的 Kotlin 文件 呢 ? Kotlin 代码 文件 可 以 分 为 两 类 : 普通 的 Kotlin 
文件 、 用 于 页 面 Activity 的 文件 ， 这 两 类 Kotlin 文件 拥有 各 自 的 创建 方式 ， 具 体 说 明 如 下 。 


1. 普通 的 Kotlin 文件 创建 

右 击 待 创建 文件 的 包 名 ， 在 弹出 的 快捷 菜单 中 依次 选择 “New” 一 “Kotlin File/Class”， 菜 单 
界面 如 图 1-23 所 示 。 

# app ) Ml src ) Mnain ) Ml java ) PI con ) Bi exanple ) BIkotlin ) BS Te enn 
Kotlin File/Class 
总 Android resource file 

Ctrl+X mM Android resource directory 

Ctrl+C Mm Sanple Data directory 
Ctrl+Shift+C 恒 File 


Copy as Plain Text 访 Scratch File Ctrl+Alt+Shift+Insert 
Copy Reference Ctrl+Alt+Shift+C py Package 
团 Paste Ctrl+y gl C++ Class 





1-23 ”通过 快捷 菜单 创建 Kotlin 文件 


也 可 在 顶部 的 主 菜单 栏 上 依次 选择 “New” 一 “Kotlin FilelClass”， 菜 单 界 面 如 图 1-24 所 示 。 

上 述 两 种 方式 都 会 打开 Kotlin 文件 的 创建 对 话 框 ， 如 图 1-25 所 示 。 这 里 在 “Name” 输 入 框 填 
写 文件 名 称 ， 在 “Kind” 下 拉 框 中 可 单 击 弹出 下 拉 列 表 ， 如 图 1-26 所 示 ， 根 据 要 求 可 选择 对 应 的 
文件 类 型 (File 表示 普通 文件 ，Class 表示 类 文件 ，Interface 表示 接口 文件 ，Enum class 表示 枚 举 文 
件 ，Object 表示 对 象 文件 ) ， 然 后 单 击 “OK ”按钮 完成 文件 创建 操作 。 


兰 
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[startkotlin - [F:\StudioProjects\StartKotlin] 
Edit Wiew Mavigate Code Analyze Ref 





后 Open. .- 
国 Profile or Debug APK... 


Close Project 
Link C++ Project with Gradle 
PF Settings. Ctrl+hlt+S 
CProject Structure... Ctrl+Alt+Shift+S 
Other Settings » 


Nev Project... 
Import Project... 

Project from Version Control 
Jew Module,.. 

Taport Nodule... 

Import Sanple... 





@ Java Class 





Android resource file 
Mm Android resource directory 
Mm Sanple Data directory 





1-24 ”通过 主 菜单 栏 创建 Kotlin 文件 


® Nev Rotlin File /Class [= 


Kind: | 电 File 国 


EZ Cancel | | Help | 
, 














1-25 Kotlin 文件 的 创建 对 话 框 
2. 用 于 页 面 Activity 的 文件 创建 



















莹 Class 
用 Interface 
三 Enum class 
三 Object 











图 1-26 选择 Kotlin 文件 的 类 型 


选中 待 创 建文 件 的 包 名 , 在 顶部 的 主 菜 单 栏 上 依次 选择 "New ”一 Activity ”一 “Empty Activity”， 


菜单 界面 如 图 1-27 所 示 。 


Stortkotlin - .F;\Studioprojects\Star totlin 
Edit Ver Navigate Code Anslyze Eef 






Nev Project. 
Inport Project... 





















Worlin\starthotl nolnAc Ivity Kt ~ Androld Studlo 9,01 





Settings Reposltor: 
局 Saye Al 
GB Smchronize 
Invalidate Caches / Restart. 
Export to HTML.,, 
导 Ertnt,., 
Add to Faverites 
Mile Encocing 
Line Separators 
Make Directory Read-only 


Pover Save Jiod- 





然后 打开 活动 Activity 的 创建 对 话 框 ,如 图 1-28 所 示 , 分 别 在 “Activity Name 


Project fron Version Control + lin Gapprp YY 者 小 mi 世 ED 
Open. .. New Nodule... Dom 
@Proftle or Debug APE... i 
ep ”Inport Sanple... 
Close Project n 
Java class 

Link C++ Froject with Cradle a 
FF Settings... CtrltAlt+s SS Androld resource file 
[FProject Structure... .CtrltAlttshift+s MM Androld rcsourcc dircctory 

Dther Settings ， We Sanple Data directory 罗 

Tnport Settines,.. Flle 这 Callery. 

Export Settings,., 如 Scratch File ”Ctrl+Alt+Shiz1tInsert rod ninsh 

Eapart to Zip gile a Package n hines I Teauires minsdt 








下 ctH Class koid Things Ter 
Ctrlr5 晶 cC/crr Source File i on 
CtrltAlt:Y 芒 CVCrt Header File B ' 

WM Inage Asset 
Wh Vector Asset 
晤 singleten 
* @ Gradle Kotlin DSL Build Script 
Gradle Kotlin DSL Settingss 
Edit Flle Tenplates.,. mm Seroliling Activity 


部 AIDL 一 Settings Activity 


= Tabbed Activity 
图 1-27 创建 用 于 页 面 Activity 的 文件 


ly 1 ntnsdk >= 
一 Botton Novigation Activity 


Fullscreen Activity 
一 Login Activity 
一 5aster/Detail Flov 


站 一 Navigatlon Draver kctivity 








和 “Layout Name 


» 


两 个 输入 框 中 填写 活动 名 称 与 布局 名 称 ， 并 在 下 方 的 源码 语言 “Source Language” 的 下 拉 列 表 中 选 
择 “Kotlin”， 表 示 新 创建 的 Activity 代码 采用 Kotlin 编码 。 
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确认 好 新 Activity 的 创建 信息 ， 单 击 “Finish” 按 钮 ，Android Studio 便 会 自动 创建 Kotlin 代码 
文件 MainActivity2.kt， 以 及 与 之 对 应 的 XML 布局 文件 activity_name2.xml。 创 建 后 的 工程 文件 结 
构 如 图 1-29 所 示 。 





区 StartKotlin =s[F:NStudioProjecte 
File Edit View Navigate Code Analyze Refi 





至 StartKotlin ) Nllocal. properties 





mdrod ME 
a v 3 app 

ee nanifests 

A java 


com. example. kotlin. startkotlin 














8 RE Main2Activity 
RE MainActivity 
| oie 四 » Pa con. exanple.kotlin startkotlin | 
pm et 加 con. exanple. kotlin. startkotlin | 
ad VY| v Bres 
日 s dravable 
3 layout 
四 晕 activity_main xnl 
2 访 activity_nain2. xnl 
nipnap 
| I | E | ua 
图 1-28 Activity 页 面 文件 的 创建 对 话 框 图 1-29 创建 新 Activity 文件 后 的 工程 目录 结构 


其 实 ，Kotlin 的 文件 创建 还 是 很 简单 的 , 掌握 这 些 基 本 的 文件 操作 可 以 为 后 面 的 工具 使 用 打 好 
基础 。 


1.3 ”SDK 安装 与 插件 升级 


本 节 主 要 介绍 Android Studio 3.0 环境 对 SDK 和 插件 的 安装 升级 说 明 ， 包 括 如 何 安装 最 新 的 
SDK、 如 何 升级 Gradle 插件 、 如 何 把 Kotlin 插件 升级 到 最 新 版 本 等 。 





1.3.1 安装 最 新 版 SDK 


由 于 目前 官方 的 Android Studio 3.0 安装 包 没有 自 带 
SDK， 安 装 过 程 也 只 会 去 下 载 Android 8.0 的 SDK (API 
26) ， 因 此 如 果 读 者 是 第 一 次 安装 Android Studio, 就 得 | 着 ， 色 mE Ga 

















自己 另外 安装 最 新 版 本 的 SDK。 首先 打开 Android Studio,， | |Spk Nanager| le 
在 界面 右上 角 的 工具 栏 中 找到 “SDK Manager” 的 图 标 ， 
如 图 1-30 所 示 。 1-30 在 工具 栏 中 找到 “SDK Manager” 


单 击 该 图 标 , 打开 Default Settings 对 话 框 ， 如 图 1-31 所 示 ， 在 对话 框 右 侧 的 SDK 列表 中 多 选 
最 上 面 的 SDK 版 本 , 比如 “Android API 27”, 然后 单 击 右 下 角 的 “Apply ”按钮 , 命令 Android Studio 
执行 该 版 本 SDK 的 下 载 操作 。 
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a Appearance & Behavior > Systea Settings ) Android SDE 
v hppearance & Behavior Manager for the Android SDE snd Tools used by Android Studio 
Appearance Android SDK Location: |D:\adt-bundle-vindos-z86_64-20140702\sdl Edit 
Nenus and Toolbars (| sor T1601s | spr waate site:| 
RE Each Android SDK Platform psckage includes the Android Platform and 
Passvords sources pertaining to an API level by default. Once installcd, Android 
i ey Studio will autonatically check for updates. Check “show package detalls” 
to display individual SDK conponents. 
Updates Nane API LevelRevision| Status I 
Usage Statistics BAndrold AFI 27 27 1 Partially installcd 
| 回 Android &.0 (Oreo) 26 z Installed 
25 3 Installed 
Notifications 24 2 Installed 
23 3 Update available 
Qa ts BAndroid 5.1 (Lol 22 2 Update available 
Fath Variables 回 Android 5. 0 (Lol 21 2 Update avallable 
Keyaap 四 Android 4.49 (Ei 20 2 Installed 
回 Android 4.4 19 Update available 
六 Rditor 加 Android 4.3 (Jelly Bean) 18 3 Jnstalled 
Plugins 回 Android 4.2 (Jelly Bean) 17 3 Update available 
回 Androld 4.1 (Jelly Bean) 16 5 Installed 
ee ee ee 加 Android 4.0.3 LIcecreaaSandwich) 15 5 Installed 
上 Tools 回 Android 4.0 (IcecreaaSandvich) 14 4 Installed 
Androi (Honeyeonb) 13 1 Installed 
BAndroid 3.1 (Honeycoab) 12 3 Jnstalled 
加 Androld 5.0 (Honeycomb) 11 2 Installed 
OD Show Package Details 


Caneel | | Arrly Help 














图 1-31 SDK 管理 器 的 版 本 管理 对 话 框 


等 待 Android Studio 下 载 并 安装 最 新 版 本 的 SDK 之 后 ， 重 启 Android Studio， 即 可 正常 使 用 该 
版 本 的 SDK 编译 工程 。 


1.3.2 ”升级 Gradle 插件 


Android Studio 3.0 支持 的 Gradle 插件 版 本 至 少 为 4.1, 然而 通常 App 工程 自 带 的 插件 版 本 不 能 
满足 要 求 ， 使 得 Android Studio 3.0 打开 已 有 工程 时 往往 要 重新 下 载 最 新 的 Gradle 插件 ， 造 成 漫长 
的 等 待 时 间 。 与 其 让 Android Studio 老 牛 破 车 般 地 下 载 Gradle， 不 如 自己 动手 将 最 新 版 的 Gradle 
插件 下 载 到 本 地 ， 然 后 重新 配置 Gradle 插件 目录 。 具 体 步 骤 如 下 : 


CT01 打开 电脑 上 的 下 载 软件 ， 输 入 Gradle 4.1 的 下 载 地 址 “http://downloads.gradle.org/ 
distributions/gradle-4.1-all.zip ”， 把 这 个 4.1 的 压缩 包 下 载 到 电脑 本 地 ,并 解压 该 压缩 包 到 指定 目录 ， 比 
如 “DAndroid\gradle-4.1”。 

E302 打开 Android Studio， 依 次 选择 菜单 “File” 一 “Settings”， 打 开设 置 对 话 框 ， 在 对 话 框 
左 侧 的 菜单 列表 再 依次 选择 “Build, Execution, Deployment” 一 “Gradle”， 此 时 对 话 框 右 侧 展示 Gradle 
插件 的 配置 界面 ， 如 图 1-32 所 示 。 

C03 在 Gradle 配置 界面 上 选中 “Use local gradle distribution”， 并 在 下 方 的 “Gradle home:” 
输入 框 中 填写 前 面 gradle-4.1-all.zip 的 解压 路 径 ， 例 如 “D:\Android\gradle-4.1”。 

(04 单 击 Gradle 配置 界面 右 下 方 的 “OK” 按 钮 ， 完 成 Gradle 插件 的 路 径 配 置 。 
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cettings 本 ~ 
区、 ) sul, Erecution, Deploysent , Gradle Sor curent p70jeet 
上 Appearance & Behavior Lirked Crsdle projects 
Keynap 
上 Editor 
Plugins 
上 Version Control LY] i pr 


T Build, Erecution, Deployxent 
Gradle 下 


O Use default eradle wrapper (recomaendea) 


OQ Vse local gradle distribution 
上 Debugger 




















Gradle hone: D: /Android/eradle-t.1 | 
Conpiler a 
Global Gradle settints 
Coverage 9 
Espresso Test Recorder a 口 offline work 
Instant Run Service directory path: |C;/Users/cuyangshen/, redle | 


Required Plugins 
上 Languages & Fronevorks a 
上 Tools 

Katlin romniler 

















图 1-32 Gradle 插件 的 配置 界面 


1.3.3 ”升级 Kotlin 插件 


Android Studio 虽然 从 3.0 开始 集成 了 Kotlin 开发 环境 , 但 只 是 内 置 了 某 个 版 本 的 Kotlin 插件 。 
比如 Android Studio 3.0.1 集成 的 Kotlin 插件 版 本 为 1.1.51， 随 着 Kotlin 语言 的 更 新 换代 , 它 的 插件 
也 得 跟着 升级 。 如 何在 Android Studio 上 手动 升级 Kotlin 插件 呢 ? 且 看 下 面 的 具体 步骤 说 明 。 

人 ET 依次 选择 菜单 “File” 一 “Settings”， 在 弹出 窗口 右边 的 输入 框 中 填写 “kotlin”， 从 已 安 
装 插件 里 筛选 出 Kotlin 插件 ， 如 图 1-33 所 示 ， 可 见 此 时 默认 安装 的 Kotlin 插件 版 本 为 1.1.51。 


settings 








G 


六 Appearance & Behavior Qrkotlin BO) Show: [Al pluginszj 


Keyaap Sort by: nsne™| KOr]i 
we 
LD 


» Version Control E Version: 1,1.51-release-Studiol.0- 
» Build, Ezecutlon, Deploynent EE (an0ua00 support 
» Languages k Francvorks 四 

» Tools 


Kotlin Conpiler 


Check or uncheck a plugin to enable or disable it. 





Install JetBrains plugin... | |[ Brovse repositories... | [ Install plugin fron disk... 





1-33 在 已 安装 插件 库 中 找到 Kotlin 插件 
人 2 插件 设置 下 方 有 一 排 三 个 按钮 ， 单 击 左边 的 “Install JetBrains plugin.…” 按 钮 ， 打 开 远 程 
的 插件 资源 窗口 。 在 该 窗口 左上 角 的 输入 框 中 填写 “Kotlin ”， 筛 选 出 符合 条 件 的 插件 列表 ， 如 图 1-34 
所 示 。 
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(Bronse Jerarains ec —=—00 ew 

















(GrFotlin @ [Category: All7) 
Sort by: nane™ 
| a Advanced Java Folding 
™ FORMATTING 
Ne FAnmotator 





”copE TOOLS 






EE lanouage support 





Typo Fixer Vendor 
| copg EDITING Leeranssra 
Plugin homepage 
Da 
| Size 
674M 


| | 
HTIP Proxy Settings,,. 























图 1-34 在 远程 资源 库 中 找到 最 新 的 Kotlin 插件 
G203 可 见 下 方 的 插件 列表 会 定位 到 符合 搜索 条 件 的 插件 位 置 ， 单 击 “Kotlin ” 
(LANGUAGES)， 窗 口 右 侧 就 会 展示 Kotlin 插件 的 详细 信息 。 发 现 远程 插件 库 中 的 Kotlin 最 新 版 本 
为 2017 年 11 月 28 日 推出 的 1.2 版 本 , 单 击 窗口 右边 的 "Update ”按钮 执行 升级 操作 。 接 着 Android Studio 
开始 自动 下 载 Kotlin 插件 ， 下 载 过 程 如 图 1-35 所 示 。 





A Browse JerBrains Plugins 





Qrkotlin © 0 |Category: All 
Sort by: nane™ LANGUAGE: 
| « Advanced Java Folding 59, 957 请 宙 宙 证 疝 | Kotlin 
™ FORNMATTING 2 weeks ag 
由 
a KAnnotator 20, 692 
" CODE TOOLS years ago | 从 1354737 downloads 


Updated 2017/11 1 release-Studio 






ES EE anguaoe suppor 


Type Fixer 




















2 454 Vendor 
™ CoDE EDITING Downloading Plugins 
C D 
| Downloading plugin Kotlin’ Background 
TAW 


HITP Proxy Settings... 














1-35 ”升级 Kotlin 插件 的 下 载 弹 窗 


FI04 等 待 Kotlin 下 载 并 更 新 完毕 , 此 时 原来 的 “Update” 按 钮 变 成 了 “Restart Android Studio” 
按钮 ， 提 示 需 要 重启 Android Studio 使 新 插件 生效 ， 如 图 1-36 所 示 。 

人 05 根据 提示 关闭 Android Studio， 再 次 启动 Android Studio， 即 可 在 Android Studio 使 用 最 
新 版 本 的 Kotlin 插件 。 
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Browse JetBrains Plusins 


i 鳃 








Gkotlin 





司 © Coieeory Hl) 





Kotlin 
GRestart Andreid Studio 





copz EDITIRC 2 aonrhs ago | JaBranssre 


HTP Promy Scttings' 




















1-36 Kotlin 下 载 并 更 新 完毕 后 的 插件 窗口 


1.4 ”Kotlin 简单 配置 


本 节 主 要 介绍 Android Studio 3.0 环境 对 Kotlin 的 编译 配置 说 明 ,包括 如 何 通过 菜单 调整 Kotlin 
编译 配置 、 如 何 手工 修改 编译 配置 文件 、 如 何 将 Java 代码 转换 成 Kotlin 代码 等 。 





调整 Kotlin 编译 配置 


1.3.3 小 节 介绍 了 如 何 将 Kotlin 插件 升级 到 最 新 版 本 ,不 过 App 工程 采取 的 Kotlin 编译 版 本 不 
一 定 跟 最 新 版 本 一 致 。 因 为 Kotlin 允许 指定 使 用 某 个 低 版 本 来 编译 工程 ， 就 像 Java 即使 已 经 推出 
1.9 版 本 ， 也 能 使 用 1.8、1.7 甚至 1.6 来 编译 Java 工程 。 
调整 App 工程 的 Kotlin 编译 版 本 很 简单 ， 依 次 选择 菜单 “File” 一 “Settings”， 在 打开 的 窗 
口 左 侧 菜 单列 表 选 中 “Kotlin Compiler”, 窗口 右边 便 会 打开 Kotlin 编译 配置 界面 , 如 图 1-37 所 示 。 


Settings wm 





@l ) Kotlin Coapiler SFor cazent projee: 
» Appearance & Behavior 
Keynap 


Repart conpiler yarnings 


Laneusge version wT 





上 Editor 





APL verci LL 
Plugins RS 








Yeredon Contsol 9 Ceroutines (experinental) Enabled with vernine 








上 Build, Execution, Deploynent 


Additional comnand line parancters: [-versicn 





上 Languagcs & Francvorks 
rv Tools 


Keep conpiler process alive between invocstions 
Eotlin to J 
Enable precise increnental compilaticr 








Target IV version 1.5 











图 1-37 Kotlin 的 编译 配置 界面 
可 以 看 到 ， 


的 Kotlin 编译 版 本 为 1.1。 


“Language version” 和 “API version ”目前 选 的 都 是 1.1， 


表示 当前 App 工程 采用 
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1.4.2 ”修改 编译 配置 文件 


只 看 菜单 界面 上 的 Kotlin 编译 配置 还 是 不 够 直截了当 ， 到 底 这 个 编译 版 本 是 在 哪个 文件 里 面 
配置 的 呢 ? 先 打开 工程 的 编译 配置 文件 build.gradle 看 看 ， 该 文件 内 容 如 图 1-38 所 示 。 


六 activiry_naln snl 。 震 WalnActivity. kt ET 





Cradle files have changed 





A project sync may be necessary for the IDE 


cn. androld. to01s. bulld: gredle:3.0.1 
org. jetbrains. kotlin:kotlin-gradle-plugin: Skotlin version” 














1-38 工程 级 别 的 编译 配置 文件 build.gradle 
图 1-38 所 示 的 build.gradle 文件 内 容 是 下 面 这 样 的 : 
buildscript { 
// 指 定 Kotlin 插件 的 版 本 ， 这 里 是 Android Studio 3.0.1 默认 的 1.1.51 
ext .kotlin version = '1.1.51' 
repositories { 


google() 
jcenter () 





} 
dependencies { 
classpath "com.android.tools.build:gradle:3.0.1" 
// 指 定 Kotlin 插件 的 路 径 
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin: 
$kotlin version" 


// NOTE: Do not place your application dependencies here; they belong 
// in the individual module build.gradle files 


} 


正如 图 1-38 框 中 标记 的 那样 , Kotlin 工程 的 编译 配置 文件 比 Java 编写 的 App 工程 多 了 两 处 修 
改 ， 说 明 如 下 : 
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(1) 定义 了 一 个 外 部 变量 ext.kotlin_version， 其 值 为 Kotlin 编译 版 本 号 “1.1.51”。 
(2) 指定 了 Kotlin 插件 的 编译 路 径 ， 即 “org.jetbrains.kotlin:kotlin-gradle-plugin:Skotlin 


Version”。 
可 是 仅仅 修改 工程 级 别 的 build.gradle 是 不 够 的 。 再 看 看 模块 级 别 的 build.gradle， 该 文件 内 容 


如 图 1-39 和 图 1-40 所 示 ， 其 中 图 1-39 所 示 为 文件 开头 部 分 的 截图 ， 图 1-40 所 示 为 文件 末尾 
dependencies 块 的 截图 。 





activity_nain. ml * | RNainActivity. kt 他 StartKotlin * | © app 


Gradle files have changed since last project sync. A project sync nay be necessary for 


hpply plugin: com. android. application” 
apply plugin: "kotlin-android’ 





apply plugin: ’kotlin-android-extensions” 





1-39 ”模块 级 别 的 编译 配置 文件 build.gradle 开头 


dependencies { 
inplenecntation filelree (dir: ’libs’. include: ["*. jar’) 
inplenentation’org. jetbrains, kotlin:kotlin-stdlib-jre?:$kotlin_version” 





Iinplenentation com android. support:appeon) T2610 
inplenentation ’ com, android. support. constraint:constraint-layout:1. 0.2’ 
testInplenentation junit: junit:4.12” 

androidiestInplenentation ’ con, android, support. test;runner:1. 0,1’ 
androldTestInplementatlon ’ con. androld, support. test, espresso:espresso-core:3. 0.1' 








图 1-40 ”模块 级 别 的 编译 配置 文件 build.gradle 末尾 
注意 图 1-39 和 图 1-40 框 中 的 部 分 ， 这 里 依然 有 两 个 地 方 与 众 不 同 ， 说 明 如 下 : 
(1) 文件 开头 增加 了 两 个 插件 ， 即 kotlin-android' 和 'kotlin-android-extensions'， 表 示 该 模块 会 
运用 Kotlin 插件 功能 。 补 充 Kotlin 插件 声明 后 的 文件 头 部 如 下 所 示 : 
apply plugin: 'com.android.application' 


apply Plugin: 'kotlin-android' 
apply Plugin: 'kotlin-android-extensions' 


(2) 文件 末尾 的 dependencies 块 增加 了 Kotlin 插件 库 的 编译 声明 ， 具 体 声明 语 句 如 下 所 示 : 
implementation "org.jetbrains.kotlin:kotlin-stdlib-jre7:$kotlin version" 


综 上 所 述 ，Kotlin 工程 与 Java 编写 的 App 工程 相 比 ， 一 共 要 调整 两 个 build.gradle 的 4 处 编译 
配置 ， 方 能 正常 支持 Kotlin 代码 的 编译 运行 。 


1.4.3 ”Java 代码 转 Kotlin 代码 


前 面 介绍 了 Kotlin 工程 的 编译 配置 说 明 ， 如 果 现在 有 一 个 Java 编码 的 App 工程 ， 要 如 何 将 其 
转换 为 Kotlin 工程 呢 ? 

假设 读者 目前 还 没有 Kotlin 基础 ， 那 么 按照 App 开发 的 常规 流程 ， 先 创建 一 个 新 模块 ， 依 次 
选择 菜单 “File” 一 “New” 一 “New Module”， 然 后 一 路 单 击 “Next” 按 钮 完成 模块 创建 。 再 按 
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照 “1.4.2 修改 编译 配置 文件 ”的 说 明 ， 给 这 个 新 模块 添加 Kotlin 编译 支持 。 接 着 打开 
MainActivityjava， 这 个 文件 的 内 容 再 熟悉 不 过 了 ， 就 是 最 简单 的 几 行 Java 代码 ， 如 下 所 示 : 
public class MainActivity extends AppCompatActivity { 
@Override 
Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) 7 
setContentView(R.layout .activity main) 


} 

现在 我 们 要 移花接木 ， 把 Java 代码 转换 为 Kotlin 代码 。 先 选中 MainActivityjava， 再 到 主 界面 
上 依次 选择 菜单 “Code” 一 “Convert Java File to Kotlin File”， 菜 单位 置 如 图 1-41 所 示 。 

代码 转换 完毕 ， 原 来 的 MainActivity.java 变 成 了 MainActivity.kt， 文 件 内 容 也 变 成 了 如 下 所 示 
的 Kotlin 代码 : 





class MainActivity : AppCompatActivity() { 
override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView (R.layout .activity main) 


} 


看 起 来 ， 这 个 Kotlin 的 语法 与 Java 似曾相识 ， 但 又 有 所 不 同 。 若 想 解 释 Kotlin 的 详细 语法 规 
则 ， 可 参见 本 书 第 2 章 到 第 5 章 的 语法 部 分 。 这 里 先 把 DEMO 跑 起 来 再 说 ， 依 次 选择 菜单 “Run” 
一 “Run hello'” 启 动 应 用 ， 正 常 的 话 ， 可 在 接 入 的 模拟 器 或 者 真 机 上 看 到 “Hello World! ”， 如 
图 1-42 所 示 。 
mr ee Build Rr Lools YC La 


JapLenent Methods ez 
Delegate Wethods. 
















Generate. .. 
Suzround it 

Towrap /Renove. . 

Conpletion 

Folding 

Insert Llve Teaplate 
Surround with Live Tenplate. 
Comnent with Line Connent 
Coment with Block Coment 
Betarmat Code 

Show Retormmat File Dislog 
nter-Indcnt Lines 

Optinize Inoorts 

Rearrange Code 


Halo Workd 





enent Domn 











图 141 将 Java 代码 转换 为 Kotlin 代码 的 图 142 Java 代码 转换 为 Kotlin 代码 之 后 的 
菜单 位 置 测试 应 用 运行 界面 
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怎么 样 ， 这 可 是 一 个 货真价实 的 用 Kotlin 开发 的 App， 都 说 万 事 开 头 难 ， 搭 建 好 Kotlin 的 开 


发 环境 ， 只 是 万 里 长 征 的 第 一 步 ， 在 下 面 的 章节 中 ， 我 们 将 继续 学 习 如 何 使 用 Kotlin 进行 Android 
开发 。 


1.5 ”Kotlin 相关 技术 





本 节 主 要 介绍 Kotlin 语言 在 编码 过 程 中 运用 的 一 些 相关 技术 ， 首 先 对 Kotlin 代码 与 Java 代码 
进行 编程 效率 的 比较 ， 然 后 分 别 曾 述 Kotlin 采用 的 Anko 库 以 及 Lambda 表达 式 的 相关 概念 以 及 有 具 
体 用 法 。 


1.5.1 Kotlin 代码 与 Java 代码 PK 


前 面 介绍 了 如 何 搭建 Kotlin 的 开发 环境 ， 可 是 这 个 开发 环境 依然 基于 Android Studio， 而 在 
Android Studio 上 使 用 Java 进行 编码 本 来 就 是 理 所 应 当 的 ， 何 必 还 要 专门 弄 个 Kotlin， 这 个 Kotlin 
相 比 Java 到 底 有 哪些 好 处 呢 ? 

我 们 可 以 把 Kotlin 看 作 是 Java 的 升级 版 , 它 不 但 完全 兼容 Java, 而 且 极 大 地 精简 了 代码 语法 ， 
从 而 使 开发 者 专注 于 业务 逻辑 的 编码 , 无 须 在 烦琐 的 代码 框架 之 问 周旋 。 当然 , 若 想 充分 运用 Kotlin 
的 优异 特性 ， 除 了 导入 Kotlin 的 核心 库 外 ， 还 得 导入 Kotlin 的 扩展 库 与 Anko 库 。 具 体 到 编译 配置 
文件 ， 则 要 进行 以 下 两 处 修改 : 

(1) 打开 项 目的 build.gradle， 补 充 添 加 Anko 库 的 版 本 号 声明 ， 以 及 Kotlin 扩展 库 的 路 径 ， 
完整 的 编译 配置 如 下 所 示 : 

buildscript { 

ext.kotlin version = "1.2"” // 指 定 Kotlin 的 编译 版 本 号 
ext.anko version = "0.9" // 指 定 Anko 库 的 版 本 号 
repositories { 
google () 
Jcenter () 
3 
dependencies { 
classpath '‘'com.android.tools.build:gradle:3.0.1' 
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin: 
$kotlin version" 
classpath "org.jetbrains .kotlin:kotlin-android-extensions: 
$kotlin version" 
} 
} 
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(2) 打开 模块 的 build.gradle， 在 文件 开头 补充 添加 Kotlin 的 扩展 插件 ， 配 置 添加 示例 如 下 : 


apply Plugin: 'kotlin-android' 
apply Plugin: 'kotlin-android-extensions' 


接着 在 dependencies 节点 下 补充 添加 Kotlin 与 Anko 插件 的 编译 说 明 ， 如 下 所 示 : 


//android Studio 3.0 开始 使 用 implementation，2.* 版 本 使 用 compile 
compile "org.jetbrains .kotlin:kotlin-stdlib:S$kotlin version" 
compile "org.jetbrains.anko:anko-common:$anko version" 


编译 配置 修改 完毕 ， 接 下 来 尝试 进行 简单 的 Kotlin 编码 ， 看 看 Kotlin 的 代码 究竟 有 多 人 么 的 
简练 。 

首先 按照 前 面 “1.2.4 新 建 Kotlin 文件 ”小 节 的 描述 , 给 该 模块 创建 一 个 名 称 为 EasyActivity.kt 
的 Kotlin 文件 , 对 应 的 布局 文件 名 则 为 activity_easy.xml。 然后 给 布局 文件 activity_easy.xml 添加 几 
个 TextView 和 Button 控件 ， 布 局 比较 简单 ， 可 参考 本 书 下 载 资源 中 的 源 代码 。 

接 下 来 是 本 小 节 的 重点 ， 以 前 开发 者 在 操纵 控件 时 ， 都 要 先 通过 findViewByld 方法 获得 控件 
对 象 ， 再 调用 相关 函数 设置 对 象 属性 。 比 如 现在 有 一 个 名 为 tv_hello 的 TextView 控件 ， 准 备 在 代 
码 中 把 tv_hello 的 显示 文本 改 为 “你 好 呀 ”， 如 果 用 Java 编码 ， 就 是 下 面 几 行 代码 : 

TextView tv hello = (TextView) findViewById(R.id.tv hello); 

tv_hello.setText ("你 好 蚜 "); 


如 果 用 Kotlin 修改 文本 这 个 功能 ， 实 现 会 是 怎么 样 的 呢 ? 下 面 就 让 我 们 实验 一 下 。 首 先 在 
EasyActivity.kt 代码 开头 补充 下 面 一 行 : 


import kotlinx.android.synthetic.main.activity easy.* 


这 行 导入 语句 的 目的 是 引进 Kotlin 的 控件 变量 自动 映射 功能 ， 接 下 来 的 代码 就 无 须 再 调用 
findViewById 方法 ， 直 接 把 控件 ID 当 作 控件 对 象 使 用 即 可 。 比 如 修改 TextView 的 显示 文本 ， 采 
用 Kotlin 编码 只 要 下 面 一 行 : 

tv_hello.setText ("你 好 蚜 ") 


如 此 一 来 , 原来 的 两 行 代码 精简 到 一 行 代码 , 去 掉 了 原先 获取 控件 对 象 的 元 余 代码 ,然而 Kotlin 
的 便利 性 并 不 仅 限于 此 ， 它 对 控件 甚至 都 无 须 调 用 set***/get*** 方 法 ， 而 允许 直接 修改 /获取 控件 
的 属性 值 ， 如 设置 文本 这 个 功能 ， 可 以 继续 简化 为 下 面 这 行 代码 : 

tv_hello.text = "你 好 呀 " 


进一步 简化 之 后 ， 原 代码 的 “set” 与 两 个 括号 都 被 去 除 ， 但 是 新 代码 反而 更 容易 理解 了 。 

也 许 有 人 说 ，Kotlin 在 这 里 只 精简 了 一 行 代 码 ， 不 见得 比 Java 有 多 大 优势 ， 那 就 继续 进行 其 
他 常见 功能 的 PK， 有 道 是 五 局 三 胜 ， 赢 得 多 才 足 以 服 众 。 上 面 的 第 一 局 为 修改 控件 文本 的 PK， 
结果 是 Kotlin 小 胜 ; 接 下 来 再 设 四 局 PK， 其 中 第 二 局 为 点 击 监听 器 的 处 理 。Button 是 Android 的 
常用 按钮 控件 ， 代 码 中 经 常 要 处 理 Button 控件 的 点 击 事件 ， 下 面 的 Java 代码 就 是 响应 Button 点 击 
的 一 个 例子 : 
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final Button btn click = (Button) findViewById(R.id.btn click); 
btn click.setOonClickListener (new View.OnClickListener() { 
@Override 
Public void onClick(View v) { 
btn_click.setText ("您 点 J 一 下 下 "); 
} 
En 


其 实 这 个 响应 功能 很 简单 ， 仅 仅 在 点 击 按钮 时 修改 按钮 文本 而 已 ， 可 是 因为 Java 需要 实现 点 
击 监听 器 ， 所 以 无 奈 还 得 写 好 几 行 的 匿名 类 代码 。 如 果 使 用 Kotlin 实现 相同 的 功能 ， 又 是 怎样 的 
呢 ? 且 看 下 面 的 Kotlin 代码 : 
btn click.setOnClickListener { btn click.text=" 您 点 J 一 下 下 " } 
不 得 了 了 ，Kotlin 内需 一 行 代码 就 完事 ， 想 不 到 吧 ， 此 局 Kotlin 完胜 。 
第 三 局 换个 Button 控件 的 长 按 事件 ， 下 面 的 Java 代码 是 响应 Button 长 按 的 一 个 例子 : 


final Button btn click long = (Button) findViewById(R.id.btn click long); 
btn click long.setOnLongClickListener (new View.OnLongClickListener() { 





@Override 

public boolean onLongClick(View v) { 
btn click long.setText ("您 长 按 了 一 小 会 "); 
return true; 


ER 
可 以 看 到 Java 代码 依旧 元 长 ， 再 看 看 Kotlin 代码 如 何 接 招 : 


btn_click long.setOnLongClickListener { btn click long.text=" 您 长 按 了 一 小 
会 "; true } 
Kotlin 仍旧 一 行 代码 搞定 ， 真 是 叫 人 刮目相看 ， 此 局 Kotlin 依然 完胜 。 
第 四 局 咱 不 比 监听 器 了 ，Java 在 匿名 类 这 块 很 吃亏 ， 那 来 比 另 一 种 常用 的 Toast 提示 功能 ， 该 
功能 的 Java 代码 只 有 一 行 : 
final Button btn toast = (Button) findViewById(R.id.btn toast); 
btn toast.setOnClickListener (new View.OnClickListener() { 
Goverride 
Public void onClick(View v) { 
Toast.makeText (EasyJavaActivity.this,，" 小 提示 : 您 点 了 一 下 下 "， 
Toast .LENGTH_ SHORT) .show () ; 


} 
Be 


上 面 外 层 的 点 击 监听 器 请 忽略 ， 正 宗 的 Toast 代码 真 的 只 有 一 行 ， 且 看 Kotlin 怎么 拆 招 : 
btn_toast.setOnClickListener { toast(" 小 提示 : 您 点 了 一 下 下 ") } 


哈哈 ，Kotlin 连同 监听 器 的 代码 ， 比 Java 的 一 行 Toast 代码 都 要 少 ， 此 局 Kotlin 继续 小 胜 。 
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可 是 为 什么 Kotlin 的 toast 函数 不 区 分 显示 时 长 呢 ? 原来 toast 方法 默认 为 短 时 显示 ， 即 
ToastLENGTH_ SHORT。 这 下 Java 方 窃 喜 ， 虽 然 我 的 代码 比较 长 ， 但 是 足够 灵活 呀 ， 想 要 短 一 点 
就 LENGTH_ SHORT， 想 要 长 一 点 就 LENGTH _ LONG。 正好 第 五 局 比试 Toast 的 长 时 提示 ， 该 功 
能 的 Java 代码 也 只 有 一 行 Toast: 

final Button btn toast long = (Button) findViewById(R.id.btn toast long); 

btn toast long.setOnLongClickListener (new View.OnLongClickListener() { 

QOverride 
Public boolean onLongClick(View v) { 
Toast .makeText (EasyJavaRctivity.this，" 长 提示 : 您 长 按 了 一 小 会 "， 
Toast .LENGTH LONG) .show(); 
return true; 
. 
Ds; 


现在 Kotlin 没 法 调用 toast 函数 了 吧 ，Java 洋洋 自得 总 算 能 够 扳 回 一 局 ， 谁 料 Kotlin 大 喝 一 声 
“看 我 来”: 
btn toast long.setOnLongClickListener { longToast ("长 提示 : 您 长 按 了 一 小 会 ") ; 
true } 


真是 未 曾 想到 ，Kotlin 另外 有 一 个 longToast 招式 ， 仅 仅 多 了 4 个 字母 而 已 ， 于 是 此 局 Kotlin 
理应 小 胜 。 

五 局 PK 下 来 ，Kotlin 大 获 全 胜 ，Java 溃不成军 ， 直 教 人 长 吁 短 叹 “ 长 江 后 浪 推 前 浪 ， 前 浪 死 
在 沙滩 上 ”。 


1.5.2 ”Anko 库 


Anko 是 使 用 Kotlin 语言 编写 的 一 个 Android 增强 库 ， 它 用 于 简化 Android 开发 时 的 Kotlin 代 
码 ， 使 得 开发 者 只 用 较 少 的 Kotlin 代码 便 能 表达 完整 的 编程 含义 ， 同 时 也 让 App 代码 变 得 更 加 简 
洁 易 懂 。 

例如 1.5.1 小 节 的 toast 和 longToast， 这 两 个 函数 就 在 Anko 库 中 定义 。 对 于 toast 函数 ， 它 在 
Anko 库 中 的 原始 定义 是 下 面 这 样 的 : 


fun Context .toast (message: CharSequence) = Toast.makeText (this, message, 
Toast .LENGTH_ SHORT) .show() 


对 于 longToast 函数 ， 它 在 Anko 库 中 的 原始 定义 是 下 面 这 样 的 : 

fun Context .longToast (message: CharSequence) = Toast.makeText (this, message, 
Toast .LENGTH_ LONG) .show () 

注意 到 Anko 库 的 Toasts.kt 文件 是 给 Context 类 添加 了 扩展 函数 toast 和 longToast， 这 意味 着 
凡是 继承 了 Context 的 类 (包括 Activity、Service 等 ) , 均 可 在 类 内 部 代码 直接 调用 toast 和 longToast 
方法 实现 弹 窗 提示 效果 ， 而 不 必 额 外 声明 工具 类 对 象 。 

为 了 正常 地 使 用 toast 和 longToast 函数 ， 要 在 代码 文件 头 部 加 上 下 面 两 行 导入 语句 : 
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import org.jetbrains.anko.toast 
import org.jetbrains.anko.longToast 


另外 ， 修 改 项 目的 build.gradle， 在 buildscript 节点 中 补充 下 面 一 行 的 Anko 库 版 本 号 定义 : 
ext.anko_version = "0.9" // 指 定 Anko 库 的 版 本 号 

同时 ,修改 模块 的 build.gradle， 在 dependencies 节点 中 补充 下 述 的 anko-common 包 编译 配置 : 
compile "org.jetbrains.anko:anko-common:$anko versionn 


当然 ， 读 者 刚 看 到 这 里 的 时 候 ， 应 该 还 不 具备 多 少 Kotlin 基础 ， 尚 无 法 理解 Kotlin 的 扩展 函 
数 与 类 继承 的 用 法 。 此 处 介绍 Anko 库 的 目的 只 是 告诉 读者 有 这 么 一 种 增强 库 ， 具 体 的 Kotlin 语法 
在 后 续 章节 会 进行 详细 和 深入 的 介绍 。 


1.5.3 Lambda 表达 式 


Lambda 表达 式 其 实 是 一 个 匿名 函数 ， 匿 名 函数 指 的 是 : 它 是 一 个 没有 名 字 的 函数 ， 但 函数 体 
的 内 部 代码 是 完整 的 。 可 是 常规 的 函数 调用 都 必须 指定 函数 名 称 ， 既 然 匿 名 函数 不 存在 函数 名 称 ， 
那么 其 他 地 方 怎样 调用 它 呢 ? 为 解答 这 个 问题 ， 先 来 看 看 Android 处 理 按钮 点 击 事件 的 Java 代码 
btn_click.setonClickListener (new View.OnClickListener() { 
@Override 
Public void onClick(View v) { 
btn_click.setText ("您 点 J 一 下 下 "); 
1 
]) 7 


上 面 的 代码 段 摘 录 于 之 前 的 “1.5.1 Kotlin 代码 与 Java 代码 PK” 小 节 ， 显 然 Java 的 这 种 写法 
太 过 喝 嗪 ， 既 创建 类 实例 又 重 写 onClick 函数 。 其 实 此 处 的 业务 逻辑 很 简单 ， 仅 仅 是 发 生 点 击 事件 
时 修改 一 下 按钮 文本 就 好 了 ， 监 听 代 码 何 必要 搞 得 这 么 复杂 呢 ? 出 现 该 现象 的 缘由 是 ，Java 是 一 
个 纯 面 向 对 象 的 语言 ， 因 此 它 必 须 按照 面向 对 象 的 完整 写法 老 老 实 实地 继承 类 ， 然 后 声明 类 实例 ， 
最 后 重 载 函数 。 

Java 设计 人 员 为 了 保持 Java 代码 的 严谨 性 和 连贯 性 , 对 于 上 述 代码 的 情况 一 直 只 能 这 么 处 理 。 
经 过 多 年 努力 ，Java 的 设计 者 终于 找到 了 符合 Java 编程 习惯 的 Lambda 表达 式 ， 也 就 是 简化 后 的 
Java 编码 ， 其 中 把 多 余 的 实例 声明 与 函数 重 载 部 分 统统 去 掉 ， 只 留 下 与 业务 相关 的 核心 代码 ， 从 
而 形成 了 下 面 的 Lambda 表达 式 代 码 : 

btn click.setOnClickListener((View v) -> { 
btn_click.setText ("您 点 7 一 下 下 "); 





Rs 
初步 精简 后 的 Lambda 表达 式 代码 只 保留 了 onClick 函数 的 输入 参数 与 函数 内 部 代码 〈 二 者 之 
间 通 过 “->” 连 接 ) ， 连 函数 名 称 也 被 省 略 掉 了 。 注 意 到 函数 内 部 未 使 用 输入 参数 v， 所 以 完全 可 
以 把 没 用 的 输入 参数 去 掉 ， 于 是 上 面 的 Lambda 代码 便 进一步 简化 成 下 面 这 样 : 
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btn click.setOnClickListener({ 
btn_click.setText ("您 点 J 一 下 下 "); 
上 
虽然 以 上 的 Lambda 代码 已 经 够 短 了 ， 可 是 仍旧 存在 改进 的 空间 。 仔 细 观 察 发 现 
setOnClickListener 函数 在 圆 括号 内 部 又 包 了 一 层 花 括号 ， 两 层 括号 紧 紧 贴 在 一 起 纯 属 浪费 ， 因 此 
完全 可 以 把 两 层 括号 简写 为 一 层 花 括 号 ， 简 写 后 的 Lambda 代码 如 下 所 示 : 
btn click.setOnClickListenert{ 
btn click.setText ("您 点 J 一 下 下 "); 
}; 
至 此 ， 采 取 Lambda 表达 式 的 Java 点 击 事件 处 理 代码 已 经 跟 下 面 的 Kotlin 代码 很 接近 了 : 


btn click.setOnClickListener { btn click.text=" 您 点 J 一 下 下 "” } 


Java 从 1.8 开始 支持 Lambda 表达 式 ， 如 果 Android Studio 采取 JDK 1.7 进行 App 开发 ，Java 
编码 是 不 能 使 用 Lambda 表达 式 的 。 由 于 Kotlin 从 一 诞生 就 支持 Lambda 表达 式 ,因此 并 不 在 乎 IDK 
版 本 是 1.7 还 是 1.8， 只 要 采用 最 新 版 本 的 Kotlin 编译 ， 都 能 正常 使 用 Lambda 表达 式 。 


1.6 小 结 





本 章 主 要 介绍 了 Kotlin 开发 环境 ( 即 Android Studio) 的 环境 搭建 ， 包 括 Kotlin 与 Android 开 
发 的 关系 、 如 何 安装 与 配置 Android Studio、 如 何 创建 Kotlin 工程 与 Kotlin 文件 、 如 何 升级 和 配置 
Android Studio 上 的 Kotlin 插件 、 如 何 调整 Kotlin 工程 的 编译 配置 ， 并 借 此 初步 认识 到 利用 Kotlin 
开发 App 带 来 的 巨大 好 处 。 

通过 本 章 的 学 习 , 读者 应 该 学 会 基于 Android Studio 环境 的 Kotlin 基本 操作 步 又， 能够 正确 配 
署 、 编 译 和 运行 Kotlin 编码 的 App 工程 ， 并 具备 进一步 提高 的 学 习 基础 。 


数据 类 型 


如 果 把 写 程序 比喻 成 盖 房子 ， 那 么 各 种 变量 相当 于 各 种 建筑 材料 ， 建 材 包括 砖头 、 水 泥 、 沙 
子 等 ， 程 序 变量 也 分 为 不 同 的 数据 类 型 ， 例 如 整 型 数 、 浮 点 数 、 数 组 、 字 符 串 以 及 更 高 级 的 各 种 容 
咒 等 。 建 筑 内 容 有 诸如 砌 砖头 、 搅 拌 泥 沙 等 处 理 操作 ， 数 据 类 型 也 拥有 自己 的 常见 操作 ， 如 转换 、 
修改 、 查 询 等 。 下 面 就 依次 介绍 如 何 使 用 Kotlin 的 各 种 数据 类 型 。 


2.1 基本 数据 类 型 


每 个 编程 语言 都 离 不 开 基本 的 数据 类 型 ， 包 括 整 型 、 浮 点 型 、 布 尔 型 等 ， 当 然 Kotlin 也 不 例 
外 。 虽 然 基本 数据 类 型 的 概念 是 老生 常 谈 ， 但 是 Kotlin 声明 基本 变量 究竟 有 哪些 特别 之 处 呢 ? 本 
节 从 基本 变量 类 型 开始 ， 逐 步 探讨 这 些 数据 类 型 的 常见 用 法 。 


2.1.1 基本 类 型 的 变量 声明 


Kotlin 的 基本 数据 类 型 跟 其 他 高 级 语言 的 分 类 一 样 ， 包 括 整 型 、 长 整 型 、 浮 点 型 、 双 精度 、 布 
尔 型 、 字 符 型 、 字 符 串 这 几 种 常见 类 型 ， 具 体 的 类 型 名 称 说 明 见 表 2-1。 


表 2-1 Kotlin 与 Java 的 基本 数据 类 型 对 比 














基本 数据 类 型 名 称 Kotlin 的 数据 类 型 Java 的 数据 类 型 
整 型 Int int 和 Integer 
长 整 型 Long long 和 Long 
浮 点 型 Float float 和 Float 
双 精 度 Double double 和 Double 








布尔 型 Boolean boolean 和 Boolean 


基本 数据 类 型 名 称 Kotlin 的 数据 类 型 Java 的 数据 类 型 
字符 型 Char char 
字符 串 String String 











看 起 来 很 熟悉 是 不 是 ，Kotlin 原来 这 么 简单 。 可 是 如 果 你 马上 敲 出 变量 声明 的 代码 , 便 会 发 现 
编译 有 问题 。 比 如 声明 一 个 最 简单 的 整 型 变量 ， 按 Java 的 写法 是 下 面 这 样 : 
int i=0; 
倘若 按照 Java 的 规则 来 书写 Kotlin 代码 ， 就 是 下 面 这 行 代码 : 
Int i=0; 
然而 Android Studio 立即 提示 编译 不 通过 ， 刚 开始 学 Kotlin 便 掉 到 坑 里 ， 看 来 要 认真 对 待 
Kotlin， 不 能 这 么 轻易 让 它 坑 蒙 拐骗 了 。 正 确 的 Kotlin 声明 变量 的 代码 是 下 面 这 样 的 : 
var dsInt = 0 
前 面 的 var 表示 后 面 是 一 个 变量 声明 语句 ， 接 着 是 “变量 名 :变量 类 型 ”的 格式 声明 ， 而 不 是 
常见 的 “变量 类 型 变量 名 ”这 种 格式 。 至 于 后 面 的 分 号 ， 则 看 该 代码 行 后 面 是 否 还 有 其 他 语句 ， 
如 果 变 量 声明 完毕 直接 回 车 换行 ， 那 么 后 面 无 须 带 分 号 ， 如 果 没 有 回 车 换行 ， 而 是 添加 其 他 语句 ， 
那么 变量 声明 语句 要 带 上 分 号 。 


2.1.2 简单 变量 之 间 的 转换 


Kotlin 变量 的 另 一 个 重要 特点 是 类 型 转换 ， 在 Java 开发 中 ， 如 int、long、float、double 类 型 
的 变量 可 以 直接 在 变量 名 前 面 加 上 诸如 (int) 、 (long) 、 (float) 、 (double) 这 种 表达 式 进行 
强制 类 型 转换 ， 对 于 int ( 整 型 ) 和 char (字符 型 ) 这 两 种 类 型 ， 甚 至 都 无 须 转换 类 型 ， 直 接 互 相 
赋值 即 可 。 但 在 Kotlin 中 ， 不 允许 通过 Java 的 前 缀 表达 式 来 强制 转换 类 型 ， 只 能 调用 类 型 转换 函 
数 输出 其 他 类 型 的 变量 ， 表 2-2 是 常见 的 几 种 类 型 转换 函数 的 说 明 。 


表 2-2 Kotlin 的 数据 类 型 转换 函数 的 说 明 

















Kotlin 的 数据 类 型 转换 函数 转换 函数 说 明 
toInt 转换 为 整 型 数 
toLong 转换 为 长 整 型 
toFloat 转换 为 浮 点 数 
toDouble 转换 为 双 精 度数 
toChar 转换 为 字符 
toString 转换 为 字符 串 





接 下 来 通过 实际 代码 观察 一 下 类 型 转换 的 过 程 ， 测 试用 到 的 类 型 转换 的 Kotlin 代码 片段 如 下 
所 示 : 


26 


im 古 


) 友 - 半 | 


让 


tym 


tv 


tv _ 


2-2 


val origin:Float = 65.0f 

tv_origin.text = origin.tostring() 

var int:Int 

btn int.setOnClickListener { int=origin.toInt(); 
convert.text=int.toString() } 

Var long:Long 

btn long.setOonClickListener { long=origin.toLong(); 
convert .text=long.toSstring() } 

var float:Float 

btn float.setOnClickListener { float=origin.toDouble() .toFloat(); 
convert .text=float .toString() } 

var double:Double 

btn double.setOnClickListener { double=origin.toDouble(); 
convert.text=double.toString() } 

var boolean:Boolean 

btn boolean.setOnClickListener { boolean=origin.isNaN(); 
convert .text=boolean.toString() } 

var char:Char 

btn char.setOnClickListener { char=origin.toChar(); 
convert .text=char.toString() } 


各 种 类 型 转换 的 操作 结果 如 图 2-1 一 图 2-3 所 示 ， 其 中 图 2-1 展示 转换 为 整 型 的 界面 效果 ， 图 


展示 转换 为 双 精 度 的 界面 效果 ， 图 2-3 展示 转换 为 字符 型 的 界面 效果 。 


grammar grammar grammar 


原始 值 : 65.0 。 转换 值 : 6 原始 值 : 原始 值 ; 65.0 。 转换 值 ; A 





图 2-1 浮 点 型 转换 为 整 型 图 2-2 浮 点 型 转换 为 双 精度 图 2-3 浮 点 型 转换 为 字符 型 
注意 到 上 述 类 型 转换 代码 的 第 一 行 变量 声明 语句 以 val 开头 ， 而 其 余 的 变量 声明 语句 均 以 var 
开头 ， 这 是 为 什么 呢 ? 其 实 val 和 var 的 区 别 在 于 ， 前 者 修饰 过 的 变量 只 能 在 第 一 次 声明 时 赋值 ， 
后 续 不 能 再 赋值 ， 而 后 者 修饰 过 的 变量 在 任何 时 候 都 允许 赋值 。 方 便 记 忆 的 话 ， 可 以 把 val 看 作 是 


Java 里 的 final 关键 字 ; 至 于 var，Java 里 面 没有 对 应 的 关键 字 ， 就 当 它 是 例行公事 好 了 。 


2.2 数 组 


2.1 节 介绍 了 基本 数据 类 型 在 Kotlin 中 的 用 法 ， 不 过 这 只 针对 单个 变量 ， 如 果 要 求 把 一 组 相同 
类 型 的 变量 排列 起 来 ， 形 成 一 个 变量 数组 ， 那 又 该 如 何 声明 和 操作 呢 ? 本 节 就 来 谈 谈 Kotlin 对 数 


组 的 常见 用 法 。 
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2.2.1 数组 变量 的 声明 
在 Java 中 声明 数组 跟 在 C 语言 中 声明 是 一 样 的 ， 以 整 型 数组 为 例 ， 声 明 数 组 并 加 以 初始 化 的 
语句 如 下 所 示 : 
int[] int array = new int[] {1, 2, 3}; 


其 他 基本 类 型 的 数组 声明 与 之 类 似 ， 只 要 把 int 奉 换 为 long、float、double、boolean、char 其 
中 之 一 即 可 。 但 在 Kotlin 中 ， 声 明 并 初始 化 一 个 整 型 数组 的 语句 是 下 面 这 样 的 : 


var int array:IntArray = intArrayof (1, 2, 3) 
两 相对 比 ， 对 于 整 型 数组 的 声明 ，Kotlin 与 Java 之 间 有 以 下 区 别 : 


(1) Kotlin 另外 提供 了 新 的 整 型 数组 类 型 ， 即 IntArray。 
(2) 分 配 一 个 常量 数组 ，Kotlin 调用 的 是 intArrayOf 方法 ， 并 不 使 用 new 关键 字 。 


推 而 广 之 ， 其 他 基本 类 型 的 数组 也 各 有 自己 的 数组 类 型 ， 以 及 对 应 分 配 常量 数组 的 初始 化 方 
法 ， 详 细 的 对 应 关系 说 明 见 表 2-3。 


表 2-3 Kotlin 基本 数据 类 型 名 称 及 其 初始 化 方法 对 应 关系 


Kotlin 的 基本 数组 类 型 数组 类 型 的 名 称 数组 类 型 的 初始 化 方法 








整 型 数组 IntArray intArrayOf 
长 整 型 数组 LongArray longArrayOf 
浮 点 数组 FloatArray floatArrayOf 
双 精 度数 组 DoubleAmray doubleArrayOf 








布尔 型 数组 BooleanArray booleanArrayOf 
字符 数组 CharArray charArrayOf 
下 面 是 这 些 基 本 类 型 数组 的 初始 化 代码 例子 : 


Var long array:LongArray = longArrayOof (1, 2, 3) 

Var float array:FloatArray = floatArrayOf (1.0f, 2.0f, 3.0f) 

Var double array:DoubleArray = doubleArrayOof (1.0, 2.0, 3.0) 

Var boolean array:BooleanArray = booleanArrayOf (true, false, true) 
Var char array:CharArray = charArrayof('a', 'b', 'c') 


不 知 读者 有 没有 注意 到 ， 上 面 的 Kotlin 数组 类 型 不 包括 字符 串 数组 ， 而 Java 是 允许 使 用 字符 
串 数组 的 ， 声 明 字 符 串 数组 的 Java 代码 示例 如 下 : 
String[] string array = new String[] {"How", "Are", "You"}; 
但 在 Kotlin 这 里 ， 并 不 存在 名 为 StringArray 的 数组 类 型 ， 因 为 String 是 一 种 特殊 的 基本 数据 类 
型 。 要 想 在 Kotlin 中 声明 字符 串 数 组 ， 得 使 用 Array<String> 类 型 ， 也 就 是 把 “String” 用 尖 括 号 包 起 
来 。 同 时 ， 分 配 字符 串 数组 的 方法 也 相应 变 成 了 arrayOf， 下 面 是 声明 字符 串 数 组 的 Kotlin 代码 : 


var string array:Array<String> = arrayOf ("How", "Are", "You") 
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这 种 字符 串 数 组 的 声明 方式 是 不 是 很 熟悉 ? 看 起 来 就 跟 Java 里 面 的 ArrayList 用 法 差不多 , 都 

是 在 尖 括 号 中 间 加 入 数据 结构 的 类 型 。 同 理 ， 其 他 类 型 的 数组 变量 也 能 通过 “Array< 数 据 类 型 >” 
的 方式 来 声明 ， 像 前 面 介绍 的 整 型 数组 ， 其 实 可 以 使 用 类 型 Array<Int>， 以 此 类 推 ， 改 造 之 后 的 各 
类 型 数组 变量 的 声明 代码 如 下 所 示 : 

Var int array:Array<Int> = arrayof (1l, 2, 3) 

var long array:Array<Long> = arrayOf(1，2，3) 

Var float array:Array<Float> = arrayOf (1.0f, 2.0f, 3.0f) 

var double array:Array<Double> = arrayOf(1.0, 2.0, 3.0) 

Var boolean array:Array<Boolean> = arrayOf (true, false, true) 

var char array:Array<Char> = arrayOf('a', 'b', 'c') 


2.2.2 ”数组 元 素 的 操作 


现在 声明 数组 和 对 数组 初始 化 的 代码 都 有 了 ， 接 下 来 还 需要 对 数组 做 进一步 的 处 理 ， 常 见 的 
处 理 包括 获取 数组 长 度 、 获 取 指定 位 置 的 数组 元 素 等 ， 这 些 操作 在 Kotlin 与 Java 之 间 的 区 别 包 括 : 


(1) 对 于 如 何 获取 数组 长 度 ，Java 使 用 .length， 而 Kotlin 使 用 .size。 
(2) 对 于 如 何 获取 指定 位 置 的 数组 元 素 ，Java 通过 方 括号 加 下 标 来 获取 ， 比 如 “int_array[0]” 
指 的 是 得 到 该 数组 的 第 一 个 元 素 ; Kotlin 也 能 通过 方 括号 加 下 标 来 获取 指定 元 素 , 不 过 Kotlin 还 拥 
有 get 和 set 两 个 方法 ， 通 过 get 方法 获取 元 素 值 ， 通 过 set 方法 修改 元 素 值 ， 看 起 来 就 像 在 操作 
ArrayList 队列 。 
下 面 是 Kotlin 操作 字符 串 数组 的 示例 代码 : 
// 声 明 字 符 串 数组 


var string array:Array<String> = arrayOf("How"，"Rre"， "You") 
btn string.setOnClickListener { 
Var str:String = "" 
var dsInt = 0 
while (i<string array.size) { 
str = str + string array[i] + ", " 
// 数 组 元 素 可 以 通过 下 标 访问 ， 也 可 通过 get 方法 访问 
//str = str + string array.get(i) + ", " 
pe 
} 
tv item list.text = str 
二 


上 述 代码 的 演示 效果 如 图 2-4 所 示 ， 可 以 看 到 字符 串 数组 内 部 的 各 元 素 都 被 逗号 分 隔 开 了 。 





数组 元 素 列表 : How, Are, You, 





图 2-4 Kotlin 操作 字符 串 数组 的 演示 界面 
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2.3 字符 串 


2.2 节 介绍 了 数组 的 声明 和 操作 ， 其 中 包括 字符 串 数 组 的 用 法 。 注 意 到 Kotlin 的 字符 串 类 型 名 
称 跟 Java 一 样 都 叫 String， 那 么 字符 串 在 Kotlin 和 Java 中 的 用 法 有 哪些 差异 呢 ? 这 便 是 本 节 所 要 
阐述 的 内 容 了 。 


2.3.1 字符 串 与 基本 类 型 的 转换 


首先 要 说 明 的 是 字符 串 类 型 与 基本 变量 类 型 之 问 的 转换 方式 ， 在 前 面 的 “2.1.2 简单 变量 之 间 
的 转换 ”中 ， 提 到 基本 数据 类 型 的 变量 可 以 通过 toString 方法 转换 为 字符 串 类 型 。 反 过 来 ， 字 符 串 
类 型 又 该 如 何 转换 为 基本 变量 类 型 呢 ? 表 2-4 展示 使 用 Kotlin 和 Java 编码 将 字符 串 转 换 为 基本 数 
据 类 型 的 对 照 方式 说 明 。 


表 2-4 字符 串 转换 为 其 他 数据 类 型 的 Kotlin 与 Java 方式 对 比 





字符 串 转换 目标 Java 的 转换 方式 

字符 串 转 整 型 字符 串 变量 的 toInt 方法 IntegerparseInt (字符 串 变量 ) 

字符 串 转 长 整 型 字符 串 变量 的 toLong 方法 Long.parseLong (字符 串 变量 ) 
字符 品 转 浮 点 数 FloatparseFloat (字符 串 变 量 ) 


字符 串 转 双 精 度数 字符 串 变量 的 toDouble 方法 Double.parseDouble (字符 串 变 量 ) 
字符 串 转 布尔 型 字符 串 变量 的 toBoolean 方法 Boolean.parseBoolean 〈 字 符 串 变量 


字符 串 转 字符 数组 字符 串 变量 的 toCharArray 方法 字符 串 变量 的 toCharArray 方法 


就 表 2-4 的 转换 情况 来 看 ，Java 的 实现 方式 比较 烦琐 ， 既 需要 其 他 类 型 的 类 名 ， 又 需要 该 类 型 
的 转换 方法 。 而 在 Kotlin 这 边 ， 转 换 类 型 相对 简单 ， 并 且 与 基本 数据 类 型 之 间 的 转换 形式 保持 一 
致 ， 即 都 是 采取 “to***0” 的 形式 。 显 而 易 见 ，Kotlin 对 字符 串 的 类 型 转换 方式 更 友好 ， 也 更 方便 
记忆 。 








2.3.2 ”字符 串 的 常用 方法 


当然 ， 转 换 类 型 只 是 字符 串 的 基本 用 法 ， 还 有 更 多 处 理 字符 串 的 其 他 用 法 ， 比 如 查找 子 串 、 
蔡 换 子 串 、 截 取 指 定位 置 的 子 串 、 按 特定 字符 分 隔 子 串 等 ， 在 这 方面 Kotlin 基本 兼容 Java 的 相关 
方法 。 对 于 查找 子 串 的 操作 ， 二 者 都 调用 indexOf 方法 ; 对 于 截取 指定 位 置 子 串 的 操作 ， 二 者 都 调 
用 substring 方法 ; 对 于 替换 子 串 的 操作 ， 二 者 都 调用 replace 方法 ， 对 于 按 特 定 字符 分 隔 子 串 的 操 
作 ， 二 者 都 调用 split 方法 。 
下 面 是 Kotlin 使 用 indexOf 和 substring 方法 进行 子 串 查找 和 截取 字符 串 的 代码 例子 : 
// 截 取 小 数 点 之 前 的 字符 串 ， 即 取 整 操作 


val origin:String = tv origin.text.toString() 
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var origin trim:String = origin 
i£ (origin trim.indezxzOf(.") > 0) 1{ 

origin trim = origin trim.substring(0, origin trim.indexOf('.')) 
} 

在 这 些 字符 串 处 理 方法 里 面 ， 唯 一 区 别 是 split 方 法 的 返回 值 ， 在 Java 中 ，split 方 法 返回 的 是 
String 数组 ， 即 String[]; 但 在 Kotlin 中 ，split 方法 返回 的 是 String 队列 ， 即 List<String>。 下 面 是 
Kotlin 使 用 split 方法 的 示例 代码 : 

// 根 据点 号 将 源 串 分 割 为 字符 串 队 列 ， 并 将 分 割 结果 显示 在 界面 上 


btn_ split.setOnClickListener { 
Var strList:List<String> = origin.split(".") 




















Var strResult:String = "" 
for (item in strList) { 
strResult = strResult + item + ", " 
上 
tv_convert.text = strResult 


’ 
分 割 字符 串 的 界面 效果 如 图 2-5 所 示 ， 可 以 看 到 源 字 
符 串 里 面 的 点 号 都 被 蔡 换 为 逗号 ， 字 符 串 末尾 也 多 了 一 个 a 
逗号 。 
若 想 获取 字符 串 某 个 位 置 的 字符 ， 这 个 看 似 简单 的 需 
求 ,， 采取 Java 实现 时 却 有 点 烦琐 ， 因 为 只 能 调用 substring 
方法 去 截取 指定 位 置 的 字符 串 , 具 体 的 Java 代 码 如 下 所 示 : ”图 2-5 Kotlin 调用 字符 串 方法 的 演示 界面 


12345678.90 


12345678, 90， 





String result = origin.substring (number, number+1); 
tv_convert.setText (result); 


通过 Kotlin 实现 上 述 需 求 就 简单 多 了 ， 因 为 Kotlin 允许 直接 通过 下 标 访问 字符 串 指 定位 置 的 
字符 ， 下 面 是 访问 字符 串 指定 位 置 的 Kotlin 代码 例子 : 
tv_convert .text = origin[number] .toString() 
同时 ，Kotlin 也 支持 字符 串 变 量 通过 get 方 法 获取 指定 位 置 上 的 字符 ， 代 码 如 下 : 
tv_convert .text = origin.get (number) .上 toString () 


如 此 一 来 ，Kotlin 的 字符 串 定位 代码 不 但 更 加 精炼 ， 而 且 可 读 性 也 增强 了 。 


2.3.3 ”字符 串 模 板 及 其 拼接 


Kotlin 对 字符 串 带 来 的 便利 并 不 限于 此 ， 举 个 例子 ， 若 Java 把 几 个 变量 拼接 成 字符 串 ， 则 要 
么 用 加 号 强行 拼接 , 要么 用 String.format 函数 进行 格式 化 。 可 是 前 者 的 拼接 加 号 时 常会 跟 数 值 相 加 
的 加 号 混淆 ， 而 后 者 的 格式 化 还 得 开发 者 死记 硬 背 ， 如 %d、%f、%s、%c、%b 等 格式 转换 符 ， 实 
在 令 人 头痛 。 对 于 字符 串 格 式 化 这 个 痛 点 ，Kotlin 恰如其分 地 进行 了 优化 ， 何 必 引 入 这 些 麻烦 的 格 
式 转换 符 呢 ? 直接 在 字符 串 中 加 入 “$ 变 量 名 ” 即 可 表示 此 处 引用 该 变量 的 值 ， 岂 不 妙 哉 ! 
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心动 不 如 行动 ， 赶 紧 动 起 手 来 ， 看 看 Kotlin 如 何 格式 化 字符 串 ， 先 来 看 一 个 示例 代码 ; 
btn_format .setOnClickListener { tv_convert.text = "字符 串 值 为 Sorigin" } 
这 里 要 注意 ， 符 号 $ 后 面 跟 变量 名 ， 系 统 会 自动 匹配 最 长 的 变量 名 。 比 如 下 面 这 行 代码 ， 打 印 
出 来 的 是 变量 origin_trim 的 值 ， 而 不 是 origin 的 值 : 
btn format.setOnClickListener { tv_convert.text = "字符 串 值 为 
S$origin trim" } 
另外 ， 有 可 能 变量 会 先进 行 运算 ， 再 把 运算 结果 拼接 到 字符 串 中 。 此 时 ， 需 要 用 大 括号 把 运 
算 表达 式 给 括 起 来 ， 具 体 代码 如 下 所 示 : 
btn length.setOnClickListener { tv_convert.text = "字符 串 长 度 为 
${origin.length}" } 
在 上 述 的 Kotlin 格式 化 代码 中 ， 美 元 符号 $ 属 于 特殊 字符 ， 因 此 不 能 直接 打印 它 ， 必 须 经 过 转 
义 才 可 以 打印 。 转 义 的 办 法 是 使 用 “S$S{***" ”表达 式 ， 该 表达 式 外 层 的 “${"}” 为 转 义 声明 ， 内 
层 的 “***” 为 需要 原样 输出 的 字符 串 ， 所 以 通过 表达 式 “$f{'$”” 即 可 打印 一 个 美元 符号 ， 示 例 代 
码 如 下 : 





btn dollar.setOnClickListener { tv_convert.text = "美元 金额 为 
${'$'}$origin" } 
如 果 只 是 对 单个 美元 符号 做 转 义 ， 也 可 直接 在 符号 $ 前 面 加 个 反 斜 杆 ， 即 变 成 “\$”， 修 改 后 
的 代码 如 下 所 示 : 
btn dollar.setOnClickListener { tv_convert.text = "美元 金额 为 
\$$origin" } 
然而 一 个 反 斜 杆 仅仅 对 一 个 字符 进行 转 义 ， 倘 若 要 对 一 个 字符 串 做 转 义 ， 也 就 是 把 某 个 字符 
串 的 所 有 字符 原样 输出 ， 那 么 只 能 采用 形 如 “S$S{***" ”的 表达 式 ， 该 表达 式 利用 单 引 号 把 待 转 义 
的 字符 串 包 起 来 ， 好 处 是 能 够 保留 该 字符 串 内 部 的 所 有 特殊 字符 。 


2.4 容 器 


Kotlin 号 称 全 面 兼容 Java， 于 是 Java 的 容器 类 仍 可 在 Kotlin 中 正常 使 用 ， 包 括 大 家 熟悉 的 队 
列 ArrayList、 映 射 HashMap 等 。 不 过 Kotlin 作为 一 门 全 新 的 语言 ， 肯 定 要 有 自己 的 容器 类 ， 不 然 
哪 天 Java 跟 Kotlin 划 清 界限 ， 那 麻烦 就 大 了 。 本 节 就 对 Kotlin 的 几 种 容器 类 进行 详细 的 说 明 。 


2.4.1 容器 的 基本 操作 


与 Java 类 似 ，Kotlin 也 拥有 三 类 基本 的 容器 ， 分 别 是 集合 Set、 队 列 List、 映 射 Map， 然 后 每 
类 容器 又 分 作 只 读 与 可 变 两 种 类 型 ， 这 是 为 了 判断 该 容器 能 否 进行 增 、 删 、 改 等 变更 操作 。Kotlin 
对 变量 的 修改 操作 很 慎重 ， 每 个 变量 在 定义 的 时 候 就 必须 指定 能 否 修改 ， 比 如 添加 val 修饰 表示 该 
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变量 不 可 修改 ,添加 var 修饰 表示 该 变量 允许 修改 。 至 于 容器 则 默认 为 只 读 容器 ， 如 果 需 要 人 允许 修 
改 该 容器 变量 , 就 需要 加 上 Mutable 前 绥 形 成 新 的 容器 , 比如 MutableSet 表示 可 变 集合 , MutableList 
表示 可 变 队列 ，MutableMap 表示 可 变 映 射 ， 只 有 可 变 的 容器 才能 够 对 其 内 部 元 素 进行 增 、 删 、 改 
操作 。 

既然 集合 Set、 队 列 List、 映 射 Map 三 者 都 属于 容器 ， 那 么 它们 必定 拥有 相同 的 容器 方法 ， 这 
些 公 共 方 法 具体 说 明 如 下 。 
isEmpty: 判断 该 容器 是 否 为 空 。 
isNotEmpty: 判断 该 容器 是 否 非 空 。 
clear: 清空 该 容器 。 
contains: 判断 该 容器 是 否 包含 指定 元 素 。 
iterator: 获取 该 容器 的 迭代 器 。 
count: 获取 该 容器 包含 的 元 素 个 数 ， 也 可 通过 size 属性 获得 元 素数 量 。 

另外 ，Kotlin 允许 在 声明 容器 变量 时 就 进行 初始 赋值 ， 如 同 对 数组 变量 进行 初始 化 那样 。 而 
Java 的 容器 类 是 无 法 同时 声明 并 初始 化 的 ， 由 此 可 见 Kotlin 的 这 点 特性 给 开发 者 带 来 很 大 便利 。 
下 面 是 一 个 初始 化 List 队列 的 Kotlin 代码 例子 : 

val satellites:List<String> = 1istOf ("水 星 "，" 人 金星 "，" 地 球 "，" 火 星 "， 

NE) 

当然 ， 不 同 容器 的 初始 化 方法 有 所 区 别 ， 各 种 容器 与 其 初始 化 方法 的 对 应 关系 见 表 2-5。 

表 2-5 Kotlin 的 容器 及 其 初始 化 方法 的 对 应 关系 


Kotlin 的 容器 容器 的 初始 化 方法 
只 恋 集 合 setOf 

可 变 集合 mutableSetOf 

只 恋 队 列 tisOf 

可 变 队列 mutableListOf 

只 恋 呐 射 [mp | mpor 

可 变 映 时 i 


以 上 介绍 了 Kotlin 容器 的 基本 用 法 ， 更 具体 的 增 、 删 、 改 、 查 等 操作 则 有 所 不 同 ， 接 下 来 分 
别 说 明 这 三 类 6 种 容器 的 详细 使 用 。 








2.4.2 ”集合 Set/MutableSet 


合 是 一 种 最 简单 的 容器 ， 它 具有 以 下 特性 : 

(1) 容器 内 部 的 元 素 不 按 顺 序 排列 ， 因 此 无 法 按照 下 标 进行 访问 。 

(2) 容器 内 部 的 元 素 存在 唯一 性 ， 通 过 哈 希 值 校 验 是 否 存在 相同 的 元 素 ， 若 存在 ， 则 将 其 覆盖 。 
因为 Set 是 只 读 集合 ， 初 始 化 赋值 后 便 不 可 更 改 ， 所 以 元 素 变更 的 方法 只 适用 于 可 变 集合 
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MutableSet， 但 MutableSet 的 变更 操作 尚 有 以 下 限制 : 
(1) MutableSet 的 add 方法 仅仅 往 集合 中 添加 元 素 ， 由 于 集合 是 无 序 的 ， 因 此 不 知道 添加 的 
具体 位 置 。 
(2) MutableSet 没有 修改 元 素 值 的 方法 ， 一 个 元 素 一旦 被 添加 ， 就 不 可 被 修改 。 
(3) MutableSet 的 remove 方法 用 于 删除 指定 元 素 , 但 无 法 删除 某 个 位 置 的 元 素 , 这 是 因为 集 
合 内 的 元 素 不 是 按 顺 序 排列 的 。 
对 于 集合 的 遍历 操作 ，Kotlin 提供 了 好 几 种 方式 ， 有 熟悉 的 for-in 循环 、 友 代 器 遍历 ， 还 有 新 
面孔 forEach 遍历 ， 这 三 种 集合 遍历 的 用 法 说 明 如 下 。 
1. for-in 循环 
与 Java 类 似 ， 通 过 for 语句 加 上 in 条 件 即 可 轻 轻松 松 依次 取出 集合 中 的 所 有 元 素 。 下 面 是 运 
用 for-in 循环 的 代码 例子 : 





val goodsMutSet:Set<String> = setOf ("iPhone8", "Mate10", "小 米 6", "OPPO R11", 
"vivo X9S"，" 魅 族 Pro6S") 

btn_set_for.setOnClickListener { 

var desc = "" 

// 使 用 for-in 语句 循环 取出 集合 中 的 每 条 记录 

for (item in goodsMutSet) { 

desc = "${desc} 名 称 : ${item}\n" 

1 

tv_set_result.text = "手机 畅销 榜 包含 以 下 ${goodsMutSet .size} 款 手机 : \n$desc" 
} 


上 述 代 码 对 应 的 界面 效果 如 图 2-6 所 示 , 可 见 初始 化 时 输入 的 6 部 手机 都 通过 遍历 操作 打印 了 


手机 畅销 榜 包含 以 下 6 款 手机 : 
名 称 : iPhone8 


: 魅族 Pro6S 








图 2-6 Kotlin 集合 的 遍历 结果 
2. 迭代 器 遍历 
达 代 器 与 指针 的 概念 有 点 接近 ， 它 自身 并 非 具 体 的 元 素 ， 而 是 指向 元 素 的 存放 地 址 ， 所 以 迭 
代 器 遍历 其 实 是 遍历 所 有 元 素 的 地 址 。 和 迭代 器 通过 hasNext 方法 判断 是 否 还 存在 下 一 个 节点 ， 如 果 
不 存在 下 一 节点 ， 就 表示 已 经 遍历 完毕 ， 它 通过 next 方法 获得 下 一 个 节点 的 元 素 ， 同 时 友 代 器 自 
身 改 为 指向 该 元 素 的 地 址 。 下 面 是 运用 迭代 器 遍历 的 代码 例子 : 
btn_set_iterator.setOnClickListener { 


Var donc = 
val iterator = goodsMutSet.iterator () 
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// 如 果 夫 代 器 还 存在 下 一 个 节点 ， 就 继续 取出 下 一 个 节点 的 记录 
while (iterator.hasNext()) { 
val item = iterator.next() 
desc = "${desc} 名 称 : ${item}\n" 
} 
tv_set result.text = "手机 畅销 榜 包含 以 下 ${goodsMutSet .size} 款 手机 : \n$desc" 
} 


3. forEach 遍历 
无 论 是 for-in 循环 还 是 迭代 器 遍历 ， 其 实 都 脱胎 于 Java 已 有 的 容器 遍历 操作 ， 代 码 书写 上 不 
够 精炼 。 为 了 将 代码 精简 到 极致 ，Kotlin 给 容器 创造 了 forEach 方法 ， 明 确 指定 该 方法 就 是 要 依次 
遍历 容器 内 部 的 元 素 。forEach 方法 在 编码 时 采用 匿名 函数 的 形式 ， 内 部 使 用 it 代表 每 个 元 素 ， 下 
面 是 运用 forEach 遍历 的 代码 例子 : 
btn set foreach.setOnClickListener { 
var desc = "" 


//forEach 内 部 使 用 it 指 代 每 条 记录 

goodsMutSet .forEach { desc = "${desc} 名 称 : ${it}\n" } 

tv_set_result.text = "手机 畅销 榜 包含 以 下 ${goodsMutSet .size} 款 手机 : \n$desc" 
} 


结合 以 上 有 关 SeVMutableSet 的 用 法 说 明 ， 可 以 发 现 集合 在 实战 中 存在 诸多 不 足 ， 主 要 包括 以 


(1) 集合 不 允许 修改 内 部 元 素 的 值 。 

(2) 集合 无 法 删除 指定 位 置 的 元 素 。 

(3) 不 能 通过 下 标 获 取 指定 位 置 的 元 素 。 

鉴于 集合 的 以 上 缺点 难以 克服 ， 故 而 实际 开发 基本 用 不 到 集合 ， 大 多 数 场合 用 的 是 它 的 两 个 
队列 和 映射 。 





兄弟 
2.4.3 ”队列 List/MutableList 


队列 是 一 种 元 素 之 间 按 照 顺序 排列 的 容器 ， 它 与 集合 的 最 大 区 别 在 于 多 了 次 序 管理 。 不 要 小 
看 这 个 有 序 性 , 正 因为 队列 建立 了 秩序 规则 , 所 以 它 比 集合 多 提供 了 如 下 功能 (注意 , 凡是 涉及 增 、 
删 、 改 的 ， 都 必须 由 MutableList 来 完成 ) : 


(1) 队列 能 够 通过 get 方法 获取 指定 位 置 的 元 素 ， 也 可 以 直接 通过 下 标 获 得 该 位 置 的 元 素 。 

(2) MutableList 的 add 方法 每 次 都 是 把 元 素 添 加 到 队列 末尾 ， 也 可 指定 添加 的 位 置 。 

(3) MutableList 的 set 方法 允许 替换 或 者 修改 指定 位 置 的 元 素 。 

(4) MutableList 的 removeAt 方法 允许 删除 指定 位 置 的 元 素 。 

(5) 队列 除了 拥有 跟 集 合 一 样 的 三 种 遍历 方式 for-in 循环 、 和 迭代 器 遍历 、forEach 遍历 ) 外 ， 
还 多 了 一 种 按 元 素 下 标 循环 遍历 的 方式 ， 具 体 的 下 标 遍 历代 码 例子 如 下 : 


第 2 章 数据 类 型 | 35 


val goodsMutList:List<String>=1istof("iPhone8"，"Matel0"，" 小 米 6"，"OPPO R11", 


"vivo X9S"，" 魅 族 Pro6S") 
btn for index.setOnClickListener { 


Var desc = "™" 


//indices 是 队列 的 下 标 数组 。 如 果 队 列 大 小 为 10， 下 标 数组 的 取 值 就 为 0 一 9 
for (i in goodsMutList.indices) { 

Val item = goodsMutList[il] 

desc = "${desc} 名 称 : ${item}\n" 


| 
tv list result.text = "手机 畅销 榜 包含 以 下 ${goodsMutList.size} 款 手机 :， \n$desc" 


} 
上 面 按 下 标 遍 历 队 列 的 代码 对 应 的 运行 界面 如 图 2-7 所 示 , 可 见 队列 中 保存 的 6 部 手机 都 通过 
遍历 显示 了 出 来 。 


grammar 


枯燥 风 全 地 
尔 


称 : iPhone8 
: Mate10 
: 小 米 6 
: OPPO R11 
: Vivo X9S 
: 魅族 Pro6S 





图 2-7 Kotlin 队列 的 遍历 结果 
(6) MutableList 提供 了 sort 系列 方法 用 于 给 队列 中 的 元 素 重新 排序 , 其 中 sortBy 方法 表示 按 
照 指定 条 件 升序 排列 ，sortByDescending 方法 表示 按照 指定 条 件 降序 排列 。 下 面 是 一 个 给 队列 排序 
的 代码 例子 〈 含 升序 和 降序 ) : 


var sortAsc = true 
btn_sort by.setOonClickListener { 
if (sortAsc) { 
//sortBy 表示 升序 排列 ， 后 面 跟 的 是 排序 条 件 
goodsMutList.sortBy { it.length } 
} else { 
//sortByDescending 表示 降序 排列 ， 后 面 跟 的 是 排序 条 件 
goodsMutList.sortByDescending { it.length } 
! 
War dence 
for (item in goodsMutList) { 
desc = "${desc} 名 称 : ${item}\n" 
1 
tv_ list result.text = "手机 畅销 榜 已 按照 S{if (sortAsc) "升序 ” else "降序 "} 重 
新 排列 : \n$desc" 


sortAsc = !sortAsc 
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队列 进行 排序 操作 后 的 演示 效果 如 图 2-8 和 图 2-9 所 示 ， 其 中 图 2-8 展示 按 升 序 排列 后 的 手机 
信息 界面 ， 图 2-9 展示 按 降序 排列 后 的 手机 信息 界面 。 


手机 畅销 榜 已 按照 长 度 升序 重新 排列 ; 手机 畅销 榜 已 按照 长 度 降序 重新 排列 : 
名 称 : 小 米 6 


称 : OPPO R11 
名 称 ; Mate10 : Vivo X9S 
名 称 : iPhone8 : iPhone8 
: 魅族 Pro6S : 魅族 Pro6S 
: OPPO R11 : Mate10 
: Vivo X9S : 小 米 6 








图 2-8 ”队列 进行 升序 排列 后 的 结果 界面 图 2-9 队列 进行 降序 排列 后 的 结果 界面 


2.4.4 映射 Map/MutableMap 


映射 内 部 保存 的 是 一 组 键 值 对 (Key-Value) ， 也 就 是 说 ， 每 个 元 素 都 由 两 部 分 构成 ， 第 一 部 分 
是 元 素 的 键 ， 相 当 于 元 素 的 名 字 ; 第 二 部 分 是 元 素 的 值 ， 存 放 着 元 素 的 详细 信息 。 元 素 的 键 与 值 是 
一 一 对 应 的 关系 ， 相 同 键 名 指向 的 键 值 是 唯一 的 ， 所 以 映射 中 每 个 元 素 的 键 名 各 不 相同 ， 这 个 特性 
使 得 映射 的 变更 操作 与 队列 存在 以 下 不 同 之 处 〈 注 意 ， 增 、 删 操作 必须 由 MutableMap 来 完成 ) : 


(1) 映射 的 containsKey 方法 判断 是 否 存在 指定 键 名 的 元 素 ，containsValue 方法 判断 是 否 存 
在 指定 键 值 的 元 素 。 

(2) MutableMap 的 put 方 法 不 单单 是 添加 元 素 , 而 是 智能 的 数据 存储 。 每 次 调用 put 方法 时 ， 
映射 会 先 根据 键 名 寻找 同名 元 素 ， 如 果 找 不 到 就 添加 新 元 素 ， 如 果 找 得 到 就 用 新 元 素 蔡 换 旧 元 素 。 

(3) MutableMap 的 remove 方法 是 通过 键 名 来 删除 元 素 的 。 

(4) 调用 mapOf 和 mutableMapOf 方法 初始 化 映射 时 , 有 两 种 方式 可 以 表达 单个 键 值 对 元 素 ， 
其 一 是 采取 “ 键 名 to 键 值 ”的 形式 ， 其 二 是 采取 Pair 配对 方式 ， 形 如 “Pair( 键 名 , 键 值 )”。 下 面 
是 这 两 种 初始 化 方式 的 代码 例子 : 

//to 方式 初始 化 映射 

var goodsMap: Map<String，String> = mapOf (" 苹 果 " to "iPhone8"，" 华 为 " to "Matel0"， 
"小 米 " to "小 米 6"，" 欧 珀 "to "OPPO R11"，" 步 步 高 " to "vivo X9s"， "魅族 " to "魅族 Pro6S") 

//Pair 方式 初始 化 映射 

var goodsMutMap: MutableMap<String, String> = mutableMapOf(Pair(" 苹 果 "， 
"iPhone8")，Pair(" 华 为",， "Mate10")，Pair ("小 米 ", "小 米 6") ，Pair (" 欧 珀 "，"OPPO R11")， 
Pair ("步步高 "，"vivo X9S")，Pair ("魅族 "，" 魅 族 Pro6S")) 

映射 的 遍历 与 集合 类 似 ， 也 有 for-in 循环 、 迭 代 器 遍历 、forEach 遍历 三 种 遍历 手段 。 但 是 由 
于 映射 的 元 素 是 一 个 键 值 对 ， 因 此 它 的 遍历 方式 与 集合 稍 有 不 同 ， 详 述 如 下 : 





1. for-in 循环 
for-in 语句 取出 来 的 是 映射 的 元 素 键 值 对 , 若 要 获取 该 元 素 的 键 名 , 还 需 访问 元 素 的 key 属性 ; 
若 要 获取 该 元 素 的 键 值 , 还 需 访问 元 素 的 value 属性 。 下 面 是 在 映射 中 运用 for-in 循环 的 代码 例子 : 
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btn map for.setOnClickListener { 
Var desc = "" 
// 使 用 for-in 语句 循环 取出 映射 中 的 每 条 记录 
for (item in goodsMutMap) { 
//item. key 表示 该 配对 的 键 ， 即 厂家 名 称 ; item.value 表示 该 配对 的 值 ， 即 手机 名 称 
desc = "${desc} 厂 家 : ${item.key}， 名称 : ${item.value}\n" 


} 
tv_map_result .text = "手机 畅销 榜 包含 以 下 ${goodsMutMap .size} 款 手机 : \n$desc" 


上 述 通 过 for-in 语句 遍历 映射 的 运行 效果 如 图 2-10 所 示 ， 可 见 映射 内 部 每 个 元 素 的 键 名 与 键 
值 都 被 获取 到 了 。 


grammar 


De 


苹果 ， 名 称 : iPhone8 
: 华为 ， 名 称 : Mate10 
: 小 米 ， 名 称 : 小 米 6 
: 欧 珀 ， 名 称 : OPPO R11 
: 步步高 ， 名 称 : vivo X9S 
: 魅族 ， 名 称 : 魅族 Pro6S 





2-10 Kotlin 映射 的 遍历 结果 


2. 迭代 器 遍历 
映射 的 迭代 器 通过 next 函数 得 到 下 一 个 元 素 ， 接 着 需 访问 该 元 素 的 key 属性 获取 键 名 ， 访 问 
该 元 素 的 value 属性 获取 键 值 。 下 面 是 在 映射 中 运用 从 代 器 遍历 的 代码 例子 : 


btn map iterator.setOnClickListener { 
Var desc = ” 

val iterator = goodsMutMap.iterator() 

// 如 果 和 迭代 器 还 存在 下 一 个 节点 ， 就 继续 取出 下 一 个 节点 的 记录 

while (iterator.hasNext()) { 
val item = iterator.next() 
desc = "${desc} 厂 家 : ${item.key}， 名 称 : ${item.value}\n" 


} 
tv_map_result.text = "手机 畅销 榜 包含 以 下 ${goodsMutMap .size} 款 手机 : \n$desc" 


} 


3. forEach 遍历 

映射 的 forEach 方法 内 部 依旧 采用 匿名 函数 的 形式 ， 同 时 把 元 素 的 key 和 value 作为 匿名 函数 
的 输入 参数 。 不 过 映射 的 forEach 函数 需要 API 24 及 以 上 版 本 支持 ， 开 发 时 注意 修改 编译 配置 。 
下 面 是 在 映射 中 运用 forEach 遍历 的 代码 例子 : 


btn map_foreach.setOnClickListener { 


Tar desc = 


// 映 射 的 forEach 函数 需要 API 24 及 以 上 版 本 支持 
//forEach 内 部 使 用 key 指 代 每 条 记录 的 键 ， 使 用 value 指 代 每 条 记录 的 值 
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goodsMap .forEach { key, value -> desc = "${desc} 厂 家 : ${key}， 名称: 
${value} \n" } 

tv _ map result.text = "手机 畅销 榜 包含 以 下 ${goodsMutMap . size} 款 手机 : \n$desc" 

//tv_map_result.text = "Map 的 forEach 函数 需要 API 24 及 以 上 版 本 支持 " 


2.5 小 结 


本 章 介 绍 了 Kotlin 开发 涉及 的 几 种 常见 数据 类 型 ， 包 括 以 整 型 、 浮 点 型 、 布 尔 型 、 字 符 型 为 
代表 的 基本 数据 类 型 ， 还 有 这 些 基本 数据 类 型 数组 的 概念 和 运用 ， 以 及 字符 串 的 各 种 常见 用 法 ， 最 
后 是 几 种 容器 的 常见 操作 方式 。 

通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 技能 : 

(1) 学 会 Kotlin 对 基本 数据 类 型 的 变量 定义 以 及 变量 之 间 的 类 型 转换 。 

(2) 学 会 Kotlin 对 基本 类 型 数组 的 声明 方式 以 及 数组 变量 的 常见 用 法 。 

(3) 学 会 Kotlin 对 字符 串 的 各 种 处 理 操作 以 及 字符 串 模板 的 书写 格式 。 

(4) 学 会 Kotlin 对 容器 的 声明 方式 及 其 增 、 删 、 改 、 查 操作 ， 包 括 集合 、 队 列 、 喘 射 三 种 基 
本 容器 。 





控制 语 名 


第 2 章 在 介绍 字符 串 和 容器 时 ， 示 例 代码 多 次 用 到 让 和 for 语 句 ， 表 面 上 看 ，Kotlin 对 控制 语 
名 的 处 理 与 Java 很 像 ， 但 实际 上 ，Kotlin 在 这 方面 做 了 不 少 改 进 ， 所 以 本 章 针对 条 件 、 循 环 、 空 
值 判断 、 等 式 判 断 等 控制 语句 进行 详细 的 说 明 。 


3.1 条 件 分 支 


条 件 分 支 是 最 简单 的 控制 语句 ， 主 要 包括 非 此 即 彼 的 两 路 分 支 以 及 如 数 家 珍 的 多 路 分 支 ， 下 
面 一 起 来 看 看 Kotlin 给 条 件 分 支 带 来 了 哪些 变化 。 


3.1.1 简单 分 支 


说 起 条 件 判断 ， 最 简单 的 莫 过 于 人 尽 皆 知 的 让 ..else... 了 ， 这 条 语句 从 C 语言 延续 到 Java， 再 
进化 到 Kotlin， 基 本 用 法 仍 是 一 样 的 ， 看 看 下 面 的 示例 代码 就 知道 了 : 


var is_odd:Boolean = true; 
tv_puzzle.text = " 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 " 
btn if simple.setOnClickListener { 
if (is_odd == true) { 
tv_answer.text = " 凉 风 有 信 的 谜底 是 “ 讽 ”" 
} else { 
tv_answer.text = "秋月 无 边 的 谜底 是 “二 ”" 
. 
is odd = !is_ odd 
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以 上 代码 的 作用 是 ， 奇 数 次 点 击 按钮 时 ， 界 面 展示 凉 风 有 信 的 谜底 ， 偶数 次 点 击 按钮 时 ， 界 
面 展 示 秋 月 无 边 的 谜底 。 看 似 不 能 再 简单 的 判断 语句 ， 谁 能 料 到 Kotlin 也 要 加 以 简化 ? 注意 到 两 
个 谜底 都 是 显示 在 控件 tv_answer 上 , 所 以 两 个 分 支 都 出 现 了 “tv_answer'text= ***” 的 语句 。Kotin 
在 这 里 要 做 的 优化 便 是 允许 分 支 语句 返回 字符 串 ， 从 而 在 条 件 语句 外 层 直接 对 tv_answer 赋值 ， 优 
化 后 的 代码 如 下 所 示 : 


btn if simple.setOnClickListener { 
tv _answer.text = if (is odd == true) { 
" 凉 风 有 信 的 谜底 是 “ 讽 ”" 
} else { 
"秋月 无 边 的 谜底 是 “二 ”" 
is odd = !is_odd 
} 
优化 后 的 代码 还 可 以 进一步 改进 ， 因 为 每 个 分 支 内 部 只 有 一 个 字符 串 返 回 值 ， 所 以 不 妨 去 掉 
大 括号 ， 并 且 把 整个 条 件 语句 精简 到 一 行 代码 ， 就 像 下 面 这 样 : 
btn if value.setOonClickListener { 
tv_answer.text = if (is_odd==true) " 凉 风 有 信 的 谜底 是 “ 讽 ”" else "秋月 无 边 的 
谜底 是 “二 ”" 
is odd = !is _ odd 
} 
精简 了 的 代码 是 不 是 似曾相识 ?仿佛 脱胎 于 Java 的 三 元 运算 符 “ 变 量 名 = 条 件 语句 ? 取 值 A: 取 
值 B”。 可 是 Kotlin 并 不 提供 这 个 三 元 运算 符 , 因为 使 用 上 述 的 ifyelse 语句 已 经 实现 了 同样 的 功能 ， 
所 以 多 余 的 三 元 运算 符 就 被 取消 了 。 
以 上 一 共 实 现 了 三 种 写法 的 Kotlin 条 件 代码 ， 这 三 种 写法 的 运行 效果 完全 一 模 一 样 ， 具 体 结 
果 如 图 3-1 和 图 3-2 所 示 ， 其 中 图 3-1 所 示 为 奇数 次 点 击 按钮 的 效果 图 ， 此 时 界面 显示 凉 风 有 信 的 
谜底 ， 图 3-2 所 示 为 偶数 次 点 击 按钮 的 效果 图 ， 此 时 界面 显示 秋月 无 边 的 谜底 。 

















谜 题 : 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 谜 题 : 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 

谜底 : 凉 风 有 信和 的 谜底 是 “ 讽 ” 谜底 : 秋月 无 边 的 谜底 是 “二 ” 

图 3-1 进入 奇数 次 点 击 分 支 的 界面 图 3-2 进入 偶数 次 点 击 分 支 的 界面 
3.1.2 多 路 分 支 


三 元 运算 符 既 然 已 经 被 取消 ， 一 旁 的 switch/case 瑟瑟 发 拌 ， 嘴 里 嘟 喷 道 : “ 俺 这 个 多 路 分 支 
还 在 不 在 呀 ? ”看 官 莫 急 , 虽然 Kotlin 对 if/else 进行 了 增强 , 但 是 仍 无 法 取代 多 路 分 支 ; 相反 的 是 ， 
Kotlin 对 多 路 分 支 的 功能 做 了 大 幅 扩 充 ， 当 然 由 于 原来 的 switch/case 机 制 存在 局 限 ， 故 而 Kotlin 
推出 新 的 关键 字 ， 即 用 when/else 来 处 理 多 路 分 支 的 条 件 判断 。 
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下 面 来 段 多 路 分 支 用 到 的 when/else 语句 的 具体 代码 例子 : 


Var count:Int = 0 


btn when simple.setOnClickListener { 


when (count) { 


0 -> tv_answer.text = " 凉 风 有 信 的 谜底 是 “ 讽 ”" 
1 -> tv_answer.text = "秋月 无 边 的 谜底 是 “二 ”" 
// 诈 语句 可 以 没有 else， 但 是 when 语句 必须 带 上 else 
else -> tv_answer.text = "好 诗 ， 这 真是 一 首 好 诗 " 


count = (count+1) % 3 


i 


从 以 上 代码 可 以 看 出 when/else 与 switch/case 有 以 下 几 点 区 别 : 


(1) 关键 字 switch 被 when 取代 。 

(2) 判断 语句 “case 常量 值 :” 被 新 语句 “常量 值 ->” 取 代 。 

(3) 每 个 分 支 后 面 的 break 语句 取消 了 ， 因 为 Kotlin 默认 一 个 分 支 处 理 完 就 直接 跳出 多 路 语 
句 ， 所 以 不 再 需要 break。 

(4) 关键 字 default 被 else 取代 。 


跟 优 化 后 的 if/else 一 样 ，Kotlin 中 的 when/else 也 允许 有 返回 值 ， 所 以 上 面 的 多 路 分 支 代码 可 
优化 为 如 下 代码 : 


btn when value.setOnClickListener { 
tv answer.text = when (count) { 


FE 


0 -> " 凉 风 有 信 的 谜底 是 “ 讽 ”" 
1 -> "秋月 无 边 的 谜底 是 “二 ”" 
else -> "好 诗 ， 这 真是 一 首 好 诗 " 


count = (count+1) % 3 


} 


以 往 Java 在 使 用 switch/case 时 有 个 限制 ， 就 是 case 后 面 只 能 跟 常 量 ， 不 能 跟 变 量 ， 否 则 编译 
不 通过 。 现 在 Kotlin 去 掉 了 这 个 限制 ， 进 行 分 支 处 理 时 允许 引入 变量 判断 ， 当 然 引入 具体 的 运算 
表达 式 也 是 可 以 的 。 引 入 变量 判断 的 演示 代码 如 下 : 
var odd:Int = 0 
var even:Int = 1 
btn when variable.setOnClickListener { 
tv_answer.text = when (count) { 


1 


odd -> " 凉 风 有 信 的 谜底 是 “ 讽 ”" 
even -> "秋月 无 边 的 谜底 是 “二 ”" 
else -> "好 诗 ， 这 真是 一 首 好 诗 " 


count = (count+1) % 3 
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引入 变量 判断 只 是 Kotlin 牛刀 小 试 ， 真 正 的 功能 扩充 还 在 后 面 。 原 来 的 switch/case 机 制 中 ， 
每 个 case 仅仅 对 应 一 个 常量 值 , 如 果 5 个 常量 值 都 要 进入 某 个 分 支 ， 就 只 能 并 列 写 5 个 case 语句 ， 
然后 才 跟 上 具体 的 分 支 处 理 语句 。 现 在 when/else 机 制 中 便 无 须 如 此 麻烦 了 ， 这 5 个 常量 值 并 排 在 
一 起 用 逗号 隔 开 即 可 ， 如 果 几 个 常量 值 刚好 是 连续 数字 ， 可 以 使 用 “in 开始 值 .. 结 束 值 ”指定 区 间 
范围 ， 举一反三 ， 若 要 求 不 在 某 个 区 间 范 围 ， 则 使 用 语句 “!in 开始 值 .结束 值 ”。 扩 展 功能 后 的 
多 路 分 支 代码 举例 如 下 : 
btn when region.setOnClickListener { 
tv answer.text = when (count) { 

1,3,5,7,9 -> " 凉 风 有 信 的 谜底 是 “ 讽 ”" 

in 13..19 -> "秋月 无 边 的 谜底 是 “二 ”" 

!in 6..10 -> " 当 里 的 当 ， 少 侠 你 来 猜 猜 " 

else -> "好 诗 ， 这 真是 一 首 好 诗 " 





count = (count+1) % 20 


上 述 代码 运行 后 的 演示 结果 如 图 3-3 一 图 3-6 所 示 ， 其 中 图 3-3 所 示 为 第 一 个 分 支 的 界面 ， 图 
3-4 所 示 为 第 二 个 分 支 的 界面 ， 图 3-5 所 示 为 第 三 个 分 支 的 界面 ， 图 3-6 所 和 示 为 最 后 一 个 分 支 〈 即 
else 分 支 ) 的 界面 。 


(elE TE 


grammar 


谜 题 : 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 迹 题 ， 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 
谜底 ， 凉 风 有 信 的 谜底 是 “ 讽 ” 





谜底 : 秋月 无 边 的 谜底 是 “二 ” 
3-3 ”进入 第 一 个 点 击 分 支 的 界面 图 3-4 进入 第 二 个 点 击 分 支 的 界面 
grammar grammar 


迹 题 ; 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 谜 题 : 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 


谜底 : 好 诗 ， 这 真是 一 首 好 诗 





谜底 : 当 里 的 当 ， 少 侠 你 来 猜 狂 


图 3-5 进入 第 三 个 点 击 分 支 的 界面 图 3-6 进入 第 四 个 点 击 分 支 的 界面 


3.1.3 ”类 型 判断 
条 件 分 支 的 精彩 还 在 继续 ，Kotlin 设 定 了 when/else 语句 不 仅仅 判断 变量 值 ， 也 可 以 判断 变量 
的 类 型 ， 如 同 Java 的 关键 字 instanceof 那样 。 比 如 Java 代码 车 想 知晓 某 个 变量 是 否 为 字符 串 类 型 ， 
则 使 用 以 下 代码 格式 进行 判断 : 
if (str instanceof String) { 


| 


那么 在 Kotlin 中 ， 关 键 字 instanceof 被 is 所 取代 ， 下 面 是 类 型 判断 的 Kotlin 代码 格式 : 
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iFf (str is String) { 


} 


同时 , 多 路 分 支 的 when/else 语句 也 支持 类 型 判断 ， 只 不 过 在 分 支 判断 时 采取 “is 变量 类 型 ->” 
这 种 形式 。 下 面 是 演示 类 型 判断 的 Kotlin 代码 ， 在 变量 countType 为 Long、Double、Float 三 种 类 
型 时 做 多 路 判断 处 理 : 


Var countType:Number; 
btn when instance.setOnClickListener { 
count = (count+1) % 3 
countType = when (count) { 
0 -> count.toLong(); 
1 -> count.toDouble() 
else -> count.toFloat () 
} 
tv_answer.text = when (countType) { 
is Long -> "此 恨 绵绵 无 绝 期 " 
is Double -> " 树 上 的 鸟 儿 成 双 对 " 
else ->" 门 泊 东 吴 万 里 船 " 


} 


上 面 类 型 判断 代码 的 演示 效果 如 图 3-7 一 图 3-9 所 示 , 其 中 图 3-7 展示 类 型 为 Long 的 界面 ,图 
3-8 展示 类 型 为 Double 的 界面 ， 图 3-9 展示 其 他 类 型 的 界面 。 


grammar grammar grammar 


谜 题 ， 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 迹 题 : 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 迹 题 : 凉 风 有 信 ， 秋 月 无 边 。 打 二 字 
谜底 : 此 恨 绵绵 无 绝 期 谜底 : 树 上 的 鸟 儿 成 双 对 谜底 : 门 泊 东 吴 万 里 船 





3-7 ”类 型 为 Long 的 分 支 界面 ”图 3-8 类 型 为 Double 的 分 支 界面 图 3-9 其 他 类 型 的 分 支 界面 


总 结 一 下 ， 对 于 条 件 分 支 的 处 理 ，Kotlin 实现 了 简单 分 支 和 多 路 分 支 ， 其 中 简单 分 支 跟 Java 
一 样 都 是 if/else 语句 ， 多 路 分 支 则 由 Java 的 switch/case 语句 升级 为 when/else 语句 。 同 时 ，Kotlin 
的 条 件 分 支 允许 有 返回 值 ， 可 算是 一 大 改进 。 另 外 ，Java 的 三 元 运算 符 “变量 名 = 条 件 语句 ? 取 值 
A: 取 值 B” 在 Kotlin 中 取消 了 , 对 应 功能 改 为 使 用 ifyelse 实现 ，Java 的 关键 字 instanceof 也 取消 了 ， 
取而代之 的 是 关键 字 is， 并 且 多 路 分 支 也 允许 判断 变量 类 型 。 








3.2 ”循环 处 理 


3.1 节 介绍 了 简单 分 支 与 多 路 分 支 的 实现 ， 控 制 语句 除了 这 两 种 条 件 分 支 之 外 ， 还 有 对 循环 处 
理 的 控制 ， 本 节 接 下 来 继续 阐述 Kotlin 如 何 对 循环 语句 进行 操作 ， 看 看 Kotlin 引入 了 哪些 新 思维 。 
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3.2.1 遍历 循环 


Koltin 处 理 循环 语句 时 依旧 采纳 了 for 和 while 关键 字 ， 只 是 在 具体 用 法 上 有 所 微调 。 首 先 来 
看 for 循环 , Java 遍历 某 个 队列 , 可 以 通过 “for (item : list)” 形 式 的 语句 进行 循环 操作 。 同样 , Kotlin 
也 能 使 用 类 似 形式 的 循环 ， 区 别 在 于 把 冒号 “:” 换 成 了 关键 字 “in”， 具 体 语句 形 如 “for (item in 
list)”。 下 面 是 Kotlin 对 数组 进行 循环 处 理 的 代码 例子 
val poemArray:Array<String> = arrayOf(" 朝 辞 白 帝 彩云 间 "， "千里 江陵 一 日 还 "， "两岸 猿 
声 啼 不 住 "， "轻舟 已 过 万 重山 ") 
btn repeat item.setOnClickListener { 
Var poem:String="" 
for (item in poemArray) { 
Poem = "$poem$item, \n" 
》 
tv_poem content.text = poem 


} 


上 述 代码 的 目的 是 将 一 个 诗句 数组 用 逗号 与 换行 符 拼 接 起 来 ， 以 便 在 界面 上 展示 完整 的 诗歌 
内 容 。 拼 接 后 的 诗歌 显示 界面 如 图 3-10 所 示 。 

注意 到 图 3-10 中 每 行 诗句 都 以 逗号 结尾 ， 这 里 有 个 句号 问题 ， 因 为 每 首 绝 句 的 第 一 、 三 行 末 
尾 才 是 逗号 ， 第 二 、 四 行 的 末尾 应 该 是 句号 ， 所 以 这 个 循环 代码 得 加 以 改进 ， 补 充 对 数组 下 标的 判 
断 ， 如 果 当 前 是 奇数 行 ， 末 尾 就 加 逗号 ， 如果 当 前 是 偶数 行 ， 末 尾 就 加 名 号。 倘若 使 用 Java 编码 ， 
要 是 涉及 下 标的 循环 ， 基 本 采取 “for (初始 的 赋值 语句 ; 满足 循环 的 条 件 判 断 ; 每 次 循环 之 后 的 增 
减 语句 )” 这 般 形式 ， 具 体 实 现 可 参考 以 下 的 示例 代码 : 


for (int i=0; i<array.length; i++) { 


出 人 意料 的 是 ，Kotlin 废除 了 “for (初始 ; 条 件 ; 增 减 )” 这 个 规则 ， 若 想 实现 上 述 功 能 ， 取 而 
代 之 的 是 “for (i in 数组 变量 .indices)” 语 句 ， 其 中 indices 表示 该 数组 变量 的 下 标 数 组 ， 每 次 循环 
都 从 下 标 数组 依次 取出 当前 元 素 的 下 标 。 根 据 该 规则 判断 下 标的 数值 ， 再 分 别 在 句 尾 添 加 逗号 或 者 
句号 ， 据 此 改造 后 的 Kotlin 代码 如 下 所 示 : 


btn repeat_ subscript.setOnClickListener { 
var poem:String="" 
//indices 表示 数组 变量 对 应 的 下 标 数 组 
for (i in poemArray.indices) { 
if (i%2 == 0) { 
Poem = "$poem$ {poemArray[i]}, \n" 
} else { 
Poem = "$poem$ {poemArray[i]}。 \n™ 
} 
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tv poem content.text = poem 


上 
代码 修正 完毕 ， 村 


中 





新 运行 测试 应 用 ， 正 确 补 充 标点 的 诗歌 显示 界面 如 图 3-11 所 示 。 











诗 名 : 晤 六 诗 名 : 时 六 这 
诗句 : 朝 辞 白 帝 彩云 间 ， 诗句 : 朝 辞 白 帝 彩云 间 ， 
二 里 江陵 一 日 还 ， 千里 江陵 一 日 还 。 
两 岸 次 声 啼 不 住 ， 两 岸 攻 声 啼 不 住 ， 
轻舟 已 过 万 重山 ， 轻舟 已 过 万 重山 。 
图 3-10 使 用 逗号 简单 拼接 后 的 诗歌 界面 图 3-11 根据 下 标 补充 标点 的 诗歌 界面 


3.2.2 条件 循环 


然而 3.2.1 小 节 取消 “for (初始 ; 条 件 ; 增 减 )” 这 个 规则 是 有 代价 的 ， 因 为 实际 开发 中 往往 存 


在 非 同一 般 的 需求 ， 比 如 对 于 以 下 几 种 情况 ，Kotlin 的 “for (iin 数组 变量 .indices)” 语 句 就 无 法 很 
好 地 处 理 : 


(1) 如 何 设 定 条 件 判断 的 起 始 值 和 终止 值 ? 

(2) 每 次 循环 之 后 的 递增 值 不 是 1 的 时 候 怎么 办 ? 
(3) 循环 方向 不 是 递增 而 是 递减 ， 又 如 何 是 好 ? 

(4) 与 条 件 判断 有 关 的 变量 不 止 一 个 ， 怎 么 办 ? 

(5) 循环 过 程 中 的 变量 ， 在 循环 结束 后 还 能 不 能 使 用 ? 


针对 以 上 情况 ,其 实 Kotlin 也 给 出 了 几 个 解决 办 法 ， 代 价 是 多 了 几 个 诸如 until、step、downTo 


这 样 的 关键 字 ， 具 体 的 用 法 例子 参见 下 列 代码 : 


// 左 闭 右 开 区 间 ， 合 法 值 包括 11， 但 不 包括 66 
Eor Nl dn E oon 

// 每 次 默认 递增 1， 这 里 改 为 每 次 递增 4 

for (1 dn 23。89 step 4) 1 se } 

// for 循环 默认 递增 ， 这 里 使 用 downTo 表示 递减 
Eoz (1 4n.50 downTo 7) | 


可 是 这 些 解决 办 法 并 不 完美 ， 因 为 业务 需求 是 千变万化 的 ， 并 非 限定 在 几 种 固定 模式 。 同 时 ， 





以 上 规则 容易 使 人 混淆 ， 一 旦 没 搞 清 楚 until 和 downTo 的 开 闭 区 间 ， 在 判断 边界 值 时 就 会 产生 问 
题 。 所 以 更 灵活 的 解决 方案 是 , 起 止 数值 、 条 件 判断 、 循环 方向 与 递增 值 都 应 当 在 代码 中 明确 指定 ， 
“for (初始 ; 条 件 ; 增 减 )” 这 个 规则 固然 废除 了 ， 但 是 开发 者 依旧 能 够 使 用 while 语句 实现 相关 功 
能 , 所 幸 Kotlin 的 while 循环 与 Java 的 处 理 是 一 致 的 , 下 面 是 使 用 while 进行 循环 判断 的 代码 例子 : 


btn_repeat_begin.setOnClickListener { 
Var poem:String="" 
var dTnt 三 0 
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while (i < poemArray.size) { 
if (i%2 ==0) { 
Poem = "$poem$ {poemArray[i]}, \n" 
} else { 
Poem = "$poem$ {poemArray[i]}。 \n" 


++ 
Poem = "${poem} 该 诗歌 一 共有 ${i} 句 。" 
tv poem content.text = poem 


} 


既然 while 语句 保留 了 下 来 ，do/while 语句 继续 保留 ， 写 法 跟 Java 相 比 也 没什么 变化 ， 采 用 
do/while 写法 的 代码 如 下 所 示 : 


btn repeat end.setOnClickListener { 
var poem:String="" 
var i:Int = 0 
dof 
if (i%2 ==0) { 
Poem = "$poem$ {poemArray[i]}, \n" 
} else { 
Poem = "$poem$ {poemArray[i]}。 \n" 
} 
++ 
} while (i < poemArray.size) 
poem = "${poem} 该 诗歌 一 共有 ${i} 句 。" 


tv_poem content.text = poem 


3.2.3 ”跳出 多 重 循环 


前 面 的 循环 处 理 其 实 都 还 中 规 中 矩 ， 只 有 内 忧 没有 外 患 ， 但 要 是 数组 里 的 诗句 本 身 就 不 完善 ， 
比如 有 空 指针 、 空 串 、 空 格 串 、 多 余 串 等 ， 此 时 就 得 进行 诗句 的 合法 性 判断 ， 如 此 方 可 输出 正常 
诗歌 文字 。 前 述 诗歌 例子 的 合法 性 判断 主要 由 以 下 两 块 代码 组 成 : 

(1) 如 果 发 现 有 空 指针 、 空 串 、 空 格 串 ， 就 忽略 此 行 ， 即 使 用 关键 字 continue 继续 下 一 个 
循环 。 

(2) 如 果 合法 诗句 达到 4 句 ， 那 么 无 论 是 否 遍 历 完成 ， 直 接 拼 好 绝句 并 结束 循环 ， 即 使 用 关 
键 字 break 跳出 循环 。 


加 入 合法 性 判断 的 Kotlin 代码 如 下 ， 其 中 主要 演示 continue 和 break 的 用 法 : 


val poem2Array:Array<String?> = arrayOf(" 朝 辞 白 帝 彩云 闻 "，nu11， "千里 江陵 一 日 还 "， 
""， "两 岸 猿 声 啼 不 住 "，"  "，" 轻 舟 已 过 万 重山 "，" 送 孟浩然 之 广陵 ") 


btn repeat continue.setOnClickListener { 
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Var poem:String="" 
Var pos:Int=-1 
Var Count :Int=0 
while (pos <= poem2Array.size) { 
post++ 
// 车 发 现 该 行 是 空 串 或 者 空格 串 ， 则 忽略 该 行 
if (poem2Array[pos] .isNullOrBlank()) 
continue 
if (count%2 ==0) { 
Poem = "$poem$ {poem2Array[pos]}, \n" 
} else { 
Poem = "$poem$ {poem2Array[pos]}。 \n" 
} 
count++ 
// 若 合法 行 数 达到 4 行 ， 则 结束 循环 
if (count == 4) 
break 
} 
tv_poem content.text = poem 


} 


看 来 合法 性 判断 用 到 的 continue 和 break，Kotlin 并 没有 做 什么 改进 呀 ? 这 是 真 的 吗 ? 如 果 是 
真 的 ， 那 真 是 “图 样 图 森 破 ”。 以 往 使 用 Java 操作 多 层 循环 的 时 候 ， 有 时 在 内 层 循环 发 现 某 种 状 
况 , 就 得 跳出 包括 外 层 循 环 在 内 的 整个 循环 。 例如 遍历 诗歌 数组 , 一 旦 在 某 个 诗句 中 找到 “一 ” 字 ， 
便 迅速 告知 外 界 “ 我 中 奖 啦 ” 之 类 的 欢呼 。 可 是 这 里 有 两 层 循环 ， 如 果 使 用 Java 编码 ， 只 能 先 跳 
出 内 层 循环 ,然后 外 层 循环 通过 判断 标志 位 再 决定 是 否 跳出 , 而 不 能 从 内 层 循 环 直接 跳出 外 层 循环 。 

现在 Kotlin 大 笔 一 挥 ， 不 用 这 么 麻烦 ， 咱 想 跳 到 哪里 就 跳 到 哪里 ， 只 消 给 外 层 循环 加 个 @ 标 
记 ， 接 着 遇 到 情况 便 直接 跳出 到 这 个 标记 ， 犹 如 孙悟空 蹦 上 筋 斗 云 ， 想 去 哪儿 就 去 哪儿 ， 多 方便 。 
这 个 创意 真 好 ， 省 事 省 力 省 心 ， 赶 紧 看 看 下 面 的 Kotlin 代码 是 怎么 实现 的 : 

btn repeat break.setOnClickListener { 
var i:Int = 0 
var is_found = false 
// 给 外 层 循环 加 个 名 叫 outside 的 标记 
outside@ while (i < poemArray.size) { 
var j:Int = 0 
Var item = poemArray[i]; 
while ( j < item.length) { 
LE (TEem[dl ss 
is_found = true 
// 发 现 情况 ， 直 接 跳出 outside 循环 


break@outside 
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以 // 如 果 内 层 循环 直接 跳出 两 层 循环 ， 那 么 下 面 的 判断 语句 就 不 需要 了 
FE if (is_found) 
Wk break 
i++ 
1 


tv_poem content.text = if (is found) "我 找到 ' 一 ' 字 啦 " else "没有 找到 ' 一 ' 
字 呀 " 
总 结 一 下 , 对 于 循环 语句 的 操作 , Kotlin 仍然 保留 for 和 while 两 种 循环 , 主要 区 别 在 于 : Kotlin 
取消 了 “for (初始 ; 条 件 ; 增 减 )” 这 个 规则 ， 同 时 新 增 了 对 跳出 多 重 循环 的 支持 (通过 “break@ 标 
记 位 ”实现 ) 。 


3.3 空 安 全 


3.2.3 小 节 末 尾 介绍 多 重 循环 的 跳出 操作 时 ， 演 示 了 发 现 空 串 则 直接 继续 下 一 循环 ， 当 时 初始 
化 字符 串 数组 使 用 了 表达 式 “val poem2Array:Array<String?> = ***”， 该 表达 式 不 免 令 人 疑惑 ， 为 
何 这 里 要 在 String 后 面 加 个 问号 ?由 此 ,本 节 就 Kotlin 如 何 判断 和 处 理 空 值 再 做 进一步 的 深入 探讨 。 


3.3.1 字符 串 的 有 效 性 判断 


以 往 的 开发 工作 中 少不了 要 跟 各 种 异常 做 斗争 ， 常 见 的 异常 种 类 包括 空 指 针 异 常 
NullPointerException、 数 组 越界 异常 ndexOutOfBoundsException、 类 型 转换 异常 ClassCastException 
等 。 其 中 ,最 让 人 头痛 的 当 数 空 指针 异常 ， 该 异常 频繁 发 生 却 又 隐藏 很 深 。 一旦 调用 某 个 空 对 象 的 
方法 ， 就 会 产生 空 指针 异常 。 可 是 Java 编码 的 时 候 编译 器 不 会 报错 ， 开 发 者 通常 也 意识 不 到 问题 ， 
只 有 App 运行 之 时 发 生 闪 退 ， 查 看 崩 淡 日 志 才 会 忱 然 大 悟 ，“ 原 来 这 里 得 加 上 变量 非 空 的 判断 ”。 

问题 的 症结 在 于 , Java 编译 器 不 会 检查 空 值 , 只 能 由 开发 者 在 代码 中 手工 增加 “if(*** != nulD)” 
的 分 支 判断 。 但 是 业务 代码 里 面 的 方法 调用 浩 若 繁星 ， 倘 若 在 每 个 方法 调用 之 前 都 加 上 非 空 判断 ， 
势必 大 量 代码 都 充满 了 “if (*** != nul)”。 这 样 做 的 后 果 不 仅 降低 了 代码 的 可 读 性 ， 而 且 给 开发 者 
带 来 不 少 的 额外 工作 量 。 

此 外 ， 空 指针 只 是 狭义 上 的 空 值 ， 广 义 上 的 空 值 除 了 空 指针 外 ， 还 包括 其 他 开发 者 认可 的 情 
况 。 比 如 说 String 类 型 ， 字 符 串 的 长 度 为 0 时 也 可 算是 空 值 ， 如 果 字 符 串 的 内 容 全 部 由 空格 组 成 ， 
某 种 意义 上 也 是 空 值 。 那 么 对 于 字符 串 的 非 空 判断 ， 用 Java 书写 见 下 面 的 示例 代码 : 

if (str!=null && str.length()>0 && str.trim().length()>0) { 


可 以 看 到 ， 以 上 的 非 空 判断 语句 有 点 了 见 长 了 ， 因 此 作为 开发 者 ， 必 须 把 会 被 多 次 调用 的 代码 
封装 成 工具 类 。 既 然 大 家 都 这 么 想 ，Android 系统 的 研发 工程 师 也 不 例外 ， 所 以 安 卓 的 SDK 已 经 
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提供 了 “TextUtils.isEmpty(***)” 这 个 公共 方法 ， 专 门 用 于 校 验 某 个 字符 串 是 否 为 空 值 。Kotlin 的 
研发 人 员 当 然 不 会 放 过 这 点 ， 就 像 读者 在 上 一 节 看 到 的 那样 ，Kotlin 通过 isNullOrBlank 函数 对 字 
符 串 进行 空 值 校 验 。 

下 面 列 出 Kotlin 校 验 字 符 串 空 值 的 几 个 方法 。 
isNullOrEmpty: 为 空 指针 或 者 字 囊 长 度 为 0 时 返回 tue， 非 空 囊 与 可 空 串 均 可 调用 。 
isNullOrBlank: 为 空 指针 、 字 串 长 度 为 0 或 者 全 为 空格 时 返回 tue， 非 空 串 与 可 空 囊 均 可 调用 。 
isEmpty: 字 串 长 度 为 0 时 返回 tue， 只 有 非 空 串 可 调用 。 
isBlank: 字 串 长 度 为 0 或 者 全 为 空格 时 返回 tue， 只 有 非 空 串 可 调用 。 
isNotEmpty: 字 串 长 度 大 于 0 时 返回 tue， 只 有 非 空 串 可 调用 。 
isNotBlank: 字 串 长 度 大 于 0 且 不 是 全 空格 串 时 返回 tue， 只 有 非 空 囊 可 调用 。 





3.3.2 ”声明 可 空 变量 


3.3.1 小 节 的 字符 串 空 值 校 验方 法 有 区 分 非 空 串 与 可 空 串 ， 这 是 缘 于 Kotlin 引入 了 空 安全 的 概 
念 ， 每 个 类 型 的 变量 都 分 作 不 可 为 室 和 可 以 为 空 两 种 。 前 面 的 文章 中 ,正常 声明 的 变量 默认 都 是 非 
空 ( 不 可 为 null) ， 比 如 下 面 声明 字符 串 变量 的 代码 : 
Var strNotNull:String = "" 
非 空 变量 要 么 在 声明 时 就 赋值 ， 要 么 在 方法 调用 前 赋值 ， 否 则 未 经 初始 化 就 调用 该 变量 的 方 
法 ，Kotlin 会 像 语 法 错误 那样 标 红 提示 : “Variable *** must be initialized”。 至 于 可 以 为 空 的 变量 ， 
可 于 声明 之 时 在 类 型 后 面 加 个 问号 ， 如 同 “3.2.3 跳出 多 重 循环 ”声明 可 空 字符 串 数 组 的 代码 “val 
poem2Array:Array<String?> = *##x”。 若 只 声明 一 个 可 空 字符 串 变 量 ， 则 具体 的 代码 例子 如 下 所 示 : 
Var strCanNull:String? 


现在 定义 了 两 个 字符 串 ， 其 中 strNotNull 为 非 空 串 ，strCanNull 为 可 空 串 。 按 照 前 面 几 个 字符 
串 空 值 校 验方 法 的 规则 ,strNotNull 允许 调用 全 部 6 个 方法 ,但 strCanNull 只 允许 调用 isNullOrEmpty 
和 isNullOrBlank 两 个 方法 。 因 为 变量 strCanNull 可 能 为 空 , 若 去 访问 一 个 空 字符 串 的 length 属性 ， 
毫 无 疑问 会 扔 出 空 指针 异常 ， 所 以 Kotlin 对 可 空 串 增加 编译 检查 ， 一 旦 发 现 某 个 可 空 的 字符 串 变 
量 调用 了 非 空 方法 ， 比 如 isEmpty、isBlank、isNotEmpty、isNotBlank 等 ， 则 Android Studio 立刻 标 
红 提 示 此 处 存在 语法 错误 : “Only *** calls are allowed on a nullable receiver of type String”。 

可 是 上 述 的 几 个 is*** 方 法 局 限于 判断 字符 串 是 否 为 空 串 ， 如 果 要 求 获 得 字符 串 的 长 度 ， 或 者 
调用 其 他 的 字符 串 方法 ， 此 时 仍然 要 判断 空 指针 。 以 获取 字符 串 长 度 为 例 ， 下 面 声明 三 个 字符 串 变 
量 ， 其 中 strA 为 非 空 串 ，strB 和 strC 都 是 可 空 串 ， 不 过 strB 为 空 而 strC 实际 有 值 ， 字 符 串 变 量 的 
声明 代码 如 下 : 

val strA:String = " 非 空 " 
val strB:String? = null 
val strC:String? = "可 空 串 " 

对 于 strA， 因 为 它 是 非 空 串 ， 所 以 可 直接 获取 length 长 度 属性 。 对 于 strB 和 strC 必须 进行 非 
空 判断 ， 否 则 编译 器 会 提示 该 行 代码 存在 错误 。 这 三 个 字符 串 的 长 度 获取 代码 如 下 所 示 : 
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var length:Int = 0 
btn length a.setOnClickListener { length=strA.length; tv_ check result.text=" 
字符 串 A 的 长 度 为 $length" } 

btn length b.setOnClickListener { 
//1length=strB.length // 这 种 写法 是 不 行 的 ， 因 为 strB 可 能 为 空 ， 会 扔 出 空 指针 异常 
length = if (strB!=null) strB.length else -1 
tv_check result.text=" 字 符 串 B 的 长 度 为 $length" 

} 

btn _ length c.setOnClickListener { 
// 即 使 strc 有 值 ， 也 必须 做 非 空 判断 ， 谁 叫 它 号 称 可 空 昵 ? 编译 器 宁可 错 杀 一 千 ， 不 可 放 过 一 个 
length = if (strC!=null) strC.length else -1 
tv_check result.text = "字符 串 c 的 长 度 为 $length" 

} 


以 上 代码 获取 字符 串 长 度 的 运行 界面 如 图 3-12 一 图 3-14 所 示 ， 其 中 图 3-12 展示 字符 串 A 的 
长 度 计算 结果 ， 图 3-13 展示 字符 串 B 的 长 度 计算 结果 ， 图 3-14 展示 字符 串 C 的 长 度 计算 结果 。 


grammar grammar grammar 


校 验 题目 : A 为 非 空 ，B 为 null，C 为 可 空 串 校 验 题目 : A 为 非 空 ，B 为 null，C 为 可 空 串 校 验 题目 : A 为 非 空 ，B 为 null，C 为 可 空 串 
校 验 结果 : 字符 申 A 的 长 度 为 2 校 验 结果 : 字符 串 B 的 长 度 为 -1 校 验 结果 : 字符 串 C 的 长 度 为 3 





图 3-12 字符 串 A 的 长 度 计算 结果 图 3-13 字符 串 B 的 长 度 计算 结果 图 3-14 字符 串 C 的 长 度 计算 结果 


3.3.3” 校 验 空 值 的 运算 符 


虽然 使 用 条 件 分 支 可 以 完成 非 空 判断 的 功能 ， 可 是 Kotlin 仍旧 嫌 它 太 嘿 唆 ， 中 国人 把 繁体 字 
简化 为 简体 字 ， 外 国人 也 想 办 法 简化 编程 语言 ， 中 外 人 士 果然 所 见 略 同 。 既 然 访 F 
属性 会 扔 出 空 指针 异常 , 那 就 加 个 标记 , 告诉 编译 器 遇 到 空 指针 别 扔 异常 , 直接 返回 空 
至 少 避免 了 处 理 异 常 的 麻烦 。 对 应 的 Kotlin 标记 代码 如 下 所 示 : 


var length null:Int? 





btn question dot.setOnClickListener { 
//? .表示 变量 为 空 时 直接 返回 nu11， 所 以 返回 值 的 变量 必须 被 声明 为 可 空 类 型 
length null = strB?.length 
tv_check result.text = "使 用 ? .得 到 字符 串 B 的 长 度 为 $length null" 
' 


从 以 上 代码 可 以 看 到 , 这 个 多 出 来 的 标记 是 个 问号 , 语句 “strB?.length” 其 实 等 价 于 “length_null 
= 让 (strB!=null) strB.length else null”。 但 是 ， 该 语句 意味 着 返回 值 仍 然 可 能 为 室 ， 如 果 不 想 在 界面 
上 展示 “null”， 还 得 另外 判断 length_null 是 否 为 空 ， 也 就 是 说 ， 这 个 做 法 并 未 实现 与 原 代 码 完 全 
一 致 的 功能 。 

没有 完成 任务 ， Kotlin 当然 不 会 罢休 , 所 以 它 又 引入 了 一 个 新 的 运算 符 “?:”, 学 名 叫 作 “Elvis 
操作 符 ”， 叫 起 来 有 点 抛 口 ， 读 者 可 以 把 它 当 作 是 Java 的 三 元 运算 符 “ 变 量 名 = 条 件 语 句 ? 取 值 A: 
取 值 B” 的 缩写 。 引 入 运算 符 “?:” 的 实现 代码 如 下 所 示 : 
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btn question colon.setOnClickListener { 

//? :表示 为 空 时 就 返回 右边 的 值 ， 即 (x!=nul11) ?x.**:y 

length = strB?.length?: -1 

tv_check result.text = "使 用 ? :得 到 字符 串 B 的 长 度 为 $length" 
上 


这 样 总 该 完事 了 吧 ? 然而 执 抛 的 Kotlin 工程 师 觉得 还 是 喝 哄 ， 因 为 经 常 上 一 行 代码 就 对 字符 
串 strB 赋值 了 ， 所 以 此 时 可 以 百分之百 保证 strB 非 空 ， 那 又 何必 浪费 口舌 呢 ? 于 是 Kotlin 引入 了 
男 一 种 运算 符 “!!”， 表 示 策 管 那么 多 ， 前 方 没 有 地 雷 ， 弟 兄 们 赶紧 上 。 把 双 感 叹 号 加 在 变量 名 称 
后 面 表示 强行 把 该 变量 从 可 空 类 型 转 为 非 空 类 型 ， 从 而 避免 变量 是 否 非 空 的 校 验 。 下 面 是 运算 符 
“4 ”的 使 用 代码 例子 : 
btn exclamation two.setOnClickListener { 
strB = " 排 雷 完毕 " 
length = strB!!.length 
tv_check_result.text = "使 用 ! ! 得 到 字符 串 B 的 长 度 为 $length" 
4 


既然 运算 符 “!!1” 强 行 放弃 了 非 空 判断 ， 开 发 者 就 得 自己 注意 排 雷 了 。 否 则 的 话 ， 一 旦 出 现 空 
指针 ，App 运行 时 依然 会 抛 出 异常 。 以 下 的 演示 代码 在 运行 时 会 扔 出 空 指针 异常 ， 故 而 增加 了 异常 
捕获 处 理 : 


btn exclamation two.setOnClickListener { 
/7! ! 表 示 不 做 非 空 判断 ， 强 制 执行 后 面 的 表达 式 ， 如 果 变 量 为 空 ， 就 会 扔 出 空 异 常 
// 所 以 只 有 在 确保 为 非 空 时 ， 才 能 使 用 ! ! 
try { 
// 即 使 返回 给 可 空 变量 length_nul1， 也 会 扔 出 异常 
length = strB!!.length 
tv_check result.text = "使 用 !! 得 到 字符 串 B 的 长 度 为 $4length" 
} catch(e:Exception) { 


tv_check_result .text = "发 现 空 指针 异常 " 





} 


总 结 一 下 ，Kotlin 引入 了 空 安全 的 概念 ， 并 在 编译 时 开展 变量 是 否 为 空 的 校 验 。 相 关 的 操作 符 
说 明 概括 如 下 : 

(1) 声明 变量 实例 时 ， 在 类 型 名 称 后 面 加 问号 ， 表 示 该 变量 可 以 为 空 。 

(2) 调用 变量 方法 时 ， 在 变量 名 称 后 面 加 问号 ， 表 示 一 旦 变量 为 空 就 返回 null。 

(3) 新 引入 运算 符 “?:”， 表 示 一 旦 变量 为 空 ， 就 返回 该 运算 符 右边 的 表达 式 。 

(4) 新 引入 运算 符 “!1”， 通 知 编译 器 不 做 非 空 校 验 。 如 果 运 行 时 发 现 变量 为 空 ， 就 扔 出 
异常 。 
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3.4 等 式 判 断 


等 式 是 编程 语言 基本 的 表达 式 之 一 ， 无 论 哪 种 高 级 语言 ， 无 一 例外 都 采用 双 等 号 “==” 判 断 
两 个 变量 是 否 相 等 ;就 算是 复杂 的 变量 ， 在 Java 中 也 可 通过 equals 函数 判断 两 个 变量 是 否 相 等 。 
按理 说 这 些 能 够 满足 绝 大 多 数 场 合 的 要 求 了 ， 那 么 Kotlin 又 给 等 式 判断 加 入 了 哪些 新 概念 呢 ? 下 
面 好 好 探讨 一 下 各 种 场合 中 的 等 式 判断 。 


3.4.1 ”结构 相等 


基本 数据 类 型 如 整 型 、 长 整 型 、 浮 点 型 、 双 精度 、 布 尔 型 ， 无 论 是 在 C/C++ 还 是 在 Java 抑或 
是 在 Kotlin， 都 使 用 双 等 号 “一 ”进行 两 个 变量 的 相等 性 判断 。 至 于 字符 串 类 型 则 比较 特殊 ， 因 为 
最 早 C 语言 是 在 内 存 中 开辟 一 块 区 域 ， 利 用 这 块 区域 存 储 字 符 串 ， 并 返回 一 个 字符 指针 指向 该 区 
域 的 首 地 址 。 此 时 ， 如 果 对 两 个 字符 指针 进行 “一 ”运算 ， 结 果 是 比较 两 个 指针 指向 的 地 址 是 否 
相等 ， 而 非 比 较 两 个 地 址 存储 的 字符 串 是 否 相 等 。 所 以 C 语言 判断 两 个 字符 串 是 否 相等 用 到 了 比 
较 字 符 串 专用 的 strcmp 函数 。 

Java 参考 了 C++， 虽然 不 再 使 用 字符 指针 ， 而 使 用 String 类 型 表示 字符 串 ， 但 是 Java 判断 两 
个 字符 串 是 否 相等 依旧 采用 equals 函数 。 从 一 个 函数 换 成 另 一 个 函数 ， 仍 然 是 换 汤 不 换 药 ， 没 有 
本 质 上 的 改变 。 

现在 Kotlin 痛定思痛 ， 决 心 要 革除 这 种 沿袭 已 久 的 积 整 ， 反 正 都 把 字符 串 当 作 跟 整 型 一 样 的 
基本 数据 类 型 ， 何 不 直接 统一 相关 的 运算 操作 符 呢 ? 因此 ， 既 然 整 型 变量 之 间 使 用 双 等 号 “==” 
进行 等 式 判断 ， 同 理 字符 串 变 量 之 问 也 能 使 用 双 等 号 “==” 来 判断 。 以 此 类 推 ， 判 断 两 个 字符 串 
是 否 不 相等 通过 不 等 运算 符 “!=” 即 可 直接 辨别 。 从 Java 到 Kotlin， 改 变 前 后 的 等 式 判 断 表达 式 对 
照 关 系 见 表 3-1。 

表 3-1 字符 串 等 值 性 的 Java 与 Kotlin 判断 方式 对 照 关 系 


字符 串 的 等 值 性 判断 要 求 Java 的 判断 方式 Kotlin 的 判断 方式 


判断 两 个 字符 串 是 否 相 等 StrA.equals(strB) strA =— strB 
判断 两 个 字符 串 是 否 不 等 !strA.equals(strB) strA != strB 





接 下 来 ， 通 过 代码 观察 一 下 等 式 判断 的 过 程 。 下 面 是 一 个 Kotlin 判断 字符 串 相等 性 的 代码 
例子 : 


val helloHe:String = "你 好 " 
val helloShe:String = " 娩 好 " 
btn equal struct.setOonClickListener { 
if (isEqual) { 
tv_check title.text = "比较 ShelloHe 和 $helloShe 是 否 相 等 " 
// 比 较 两 个 字符 串 是 否 相 等 的 Java 写法 是 helloHe .equals (helloShe) 
Val result = helloHe == belloShe 
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tv_check result.text = "== 的 比较 结果 是 $result" 

} else { 
tv_check title.text = "比较 ShelloHe 和 $helloShe 是 否 不 等 " 
// 比 较 两 个 字符 串 是 否 不 等 的 Java 写法 是 !helloHe.equals (helloShe) 
val result = helloHe != helloShe 
tv_check result.text = "!= 的 比较 结果 是 Sresult" 

isEqual = !isEqual 


上 述 代 码 的 字符 串 相等 判断 运行 界面 如 图 3-15 和 图 3-16 所 示 ， 其 中 图 3-15 展示 helloHe 与 
helloShe 是 否 相 等 的 判断 结果 ， 图 3-16 展示 helloHe 与 helloShe 是 否 不 等 的 判断 结果 。 


grammar grammar 


判断 条 件 ， ”比较 你 好 和 你 好 是 否 相等 判断 条 件 ; 。 比较 你 好 和 你 好 是 否 不 等 
判断 结果 : == 的 比较 结果 是 false 判断 结果 : {= 的 比较 结果 是 true 





图 3-15 ”两 个 字符 串 是 否 相等 的 判断 结果 图 3-16 两 个 字符 串 是 否 不 等 的 判断 结果 


推 而 广 之 ,不 单单 字符 串 String 类 型 ,凡是 Java 中 实现 了 equals 函数 的 类 , 其 变量 均 可 在 Kotlin 
中 通过 运算 符 “==” 和 “!=” 进 行 等 式 判断 。 这 种 不 比较 存储 地 址 ， 而 是 比较 变量 结构 内 部 值 的 行 
为 ，Kotlin 称 之 为 结构 相等 ， 即 模样 相等 ， 通 俗 地 说 就 是 一 模 一 样 。 


3.4.2 引用 相等 


有 时 候 仅仅 判断 两 个 变量 值 是 否 相等 并 不 足以 完成 某 种 一 致 性 判断 ， 现 实生 活 中 还 有 更 严格 
的 真 伪 鉴 定 需求 ， 比 如 真 假 美 猴 王 、 文 物 的 真品 与 厢 品 、 兰 亭 集 序 的 真迹 与 草本 等 。 倘 若 按照 结构 
相等 的 判断 标准 ， 复 制品 和 真品 在 外 观 上 没有 区 别 ， 毫 无 疑问 就 是 相等 的 。 但 这 个 相等 的 比较 结果 
明显 与 大 众 的 认 知 相悖 ， 因 为 真品 是 唯一 的 ， 复 制品 再 怎么 逼真 也 不 可 能 与 真品 等 价 ， 所 以 结构 相 
等 并 不 适用 于 真 伪 鉴 定 。 判 断 真 伪 需要 另 一 种 由 内 而 外 全 部 相等 的 判断 准则 , 该 准则 叫 作 引用 相等 ， 
意思 是 除了 值 相等 以 外 ， 还 要 求 引 用 的 地 址 〈 即 存储 地 址 ) 也 必须 相等 。 

在 Kotlin 中 , 结构 相等 的 运算 符 是 双 等 号 “一 ”, 那么 引用 相等 的 运算 符 便 是 三 个 等 号 “===”， 
多 出 来 的 一 个 等 号 表示 连 地 址 都 要 相等 ， 结 构 不 等 的 运算 符 是 “!=”， 相 对 应 地 ， 引 用 不 等 的 运算 
符 是 “! 一 ”。 不 过 在 大 多 数 场合 ， 结 构 相 等 和 引用 相等 的 判断 结果 是 一 致 的 。 下 面 列 出 几 种 常见 
的 等 式 判断 情景 。 

(1) 对 于 基本 数据 类 型 ， 包 括 整 型 、 浮 点 型 、 布 尔 型 、 字 符 串 ， 结 构 相 等 和 引用 相等 没有 
区 别 。 

(2) 同一 个 类 声明 的 不 同 变量 , 只 要 有 一 个 属性 不 相等 , 则 其 既是 结构 不 等 ,也 是 引用 不 等 。 

(3) 同一 个 类 声明 的 不 同 变量 ， 若 equals 方法 校 验 的 每 个 属性 都 相等 (和 壁 如 通过 clone 方法 
克隆 而 来 的 变量 复制 品 ) ， 则 其 结构 相等 ， 但 引用 不 等 。 
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为 了 详细 说 明 以 上 的 等 式 判 断 过 程 ， 下 面 给 出 具体 的 代码 例子 ， 利 用 系统 自 带 的 时 间 Date 类 
演示 一 下 结构 相等 和 引用 相等 的 区 别 : 
val datel:Date = Date() 
val date2:Any = datel.clone() // 从 datel 原样 克隆 一 份 到 date2 
btn equal refer.setOnClickListener { 
when (count++%4) { 
0 => { 
tv_check title.text = "比较 datel 和 date2 是 否 结构 相等 " 
// 结 构 相 等 比较 的 是 二 者 的 值 


val result = datel == date2 

tv_check result.text = "== 的 比较 结果 是 $result" 
} 
1 -> { 


tv_check title.text = "比较 datel 和 date2 是 否 结构 不 等 " 
// 结 构 不 等 比较 的 是 二 者 的 值 


val result = datel != date2 
tv_check _ result.text = "!= 的 比较 结果 是 $result" 
} 
2 


tv_check title.text = "比较 datel 和 date2 是 否 引用 相等 " 
// 引 用 相等 比较 的 是 二 者 是 不 是 同一 个 东西 ， 即 使 克隆 地 一 模 一 样 也 不 是 一 个 东西 


val result = datel === date2 





tv_check_result .text = "=== 的 比较 结果 是 $result" 
} 
else -> { 
tv_check title.text = "比较 datel 和 date2 是 否 引用 不 等 " 
// 引 用 相等 倒 过 来 便 是 引用 不 等 
val result = datel !== date2 
tv_check result.text = "!== 的 比较 结果 是 $result" 


上 述 代 码 中 的 日 期 变量 date2 从 datel 克隆 而 来 ， 所 以 二 者 的 值 是 完全 一 样 的 ， 区 别 仅 仅 是 存 
储 的 地 址 不 同 。 接 着 使 用 双 等 号 “==” 以 及 “!=” 进 行 结构 相 等 判断 ， 运 算 结 果 为 相等 ， 有 具体 如 图 
3-17 和 图 3-18 所 示 ， 其 中 图 3-17 展示 “==” 的 判断 结果 ， 图 3-18 展示 “!=” 的 判断 结果 。 


grammar grammar 


判断 条 件 ， 比 较 date1 和 2 是 否 结构 相 判断 条 件 : 比较 date1 和 2 是 否 结构 不 


判断 结果 : == 的 比较 结果 是 true 判断 结果 : != 的 比较 结果 是 false 





图 3-17 结构 相等 的 判断 结果 图 3-18 ”结构 不 等 的 判断 结果 
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继续 使 用 三 等 号 “= 一 ”以 及 “! 一 ”进行 两 个 日 期 变量 的 引用 相等 判断 ， 运 算 结果 却 是 不 等 ， 
具体 如 图 3-19 和 图 3-20 所 示 ， 其 中 图 3-19 展示 “一 =” 的 判断 结果 ， 图 3-20 展示 “! 一 ”的 判断 
结果 。 








判断 条 件 ， 比较 date1 和 eae 是 否 引用 相 判断 条 件 ， 比 较 date1 和 es 是 否 引用 不 
判断 结果 : === 的 比较 结果 是 false 判断 结果 : !== 的 比较 结果 是 true 
3-19 引用 相等 的 判断 结果 图 3-20 引用 不 等 的 判断 结果 


以 上 的 实验 结果 证 明 引 用 相等 校 验 的 是 变量 的 唯一 性 ， 而 结构 相等 校 验 的 是 变量 的 等 值 性 。 


3.4.3 s 和 in 


除了 判断 两 个 变量 是 否 相等 之 外 ， 还 有 其 他 维度 的 等 式 判 断 ， 例 如 校 验 变 量 是 否 为 某 种 类 型 、 
校 验 数 组 中 是 否 存在 某 个 元 素 等 ， 对 于 这 些 特殊 的 等 式 判 断 , 还 得 具体 问题 具体 分 析 。 下 面 对 这 里 
举例 的 两 种 特殊 等 式 判断 进行 说 明 。 


1. 运算 符 is 和 1!is 

辟 如 校 验 变量 是 否 为 某 种 类 型 ， 按 照 Java 的 写法 自然 采用 instanceof， 具 体 判 断 语 句 形 如 “ 变 
量 名称 instanceof 类 型 名 称 ”; 如 果 校 验 变量 是 否 非 某 种 类 型 ， 就 需 在 instanceof 外 层 再 加 上 “1!1” 
这 个 非 运算 符 ， 具 体 语句 形 如 “!( 变 量 名 称 instanceof 类 型 名 称 )”。 由 此 可 见 ，Java 的 类 型 判断 
方式 不 是 太 精 简 ， 尤 其 是 校 验 不 为 某 种 类 型 的 表达 式 有 点 喝 唆 。 

在 Kotlin 中 , 若 要 校 验 变量 是 否 为 某 种 类 型 ， 使 用 的 关键 字 是 is, 具体 写法 形 如 “变量 名 称 is 
类 型 名 称 ”; 若 要 校 验 变量 是 否 不 为 某 种 类 型 , 使 用 的 关键 字 是 !is, 具体 写法 形 如 “变量 名 称 !is 类 
型 名 称 ”。 与 Java 相 比 ，Kotlin 的 类 型 判断 足够 精炼 ， 表 达 起 来 也 更 加 方便 。 下 面 来 看 看 Kotlin 
判断 变量 类 型 的 一 个 代码 例子 : 

val oneLong:Long = 1L 
btn_equal_type.setOnClickListener { 
if (isEqual) { 
tv_check title.text = "比较 oneLong 是 否 为 长 整 型 " 
//is 用 于 判断 是 否 等 于 某 种 类 型 ， 对 应 的 Java 关键 字 是 instanceof 
val result = oneLong is Long 
tv_check result.text = "is 的 比较 结果 是 $result" 
y else { 
tv_check title.text = "比较 oneLong 是 否 非 长 整 型 " 
//!is 用 于 判断 是 否 不 等 于 某 种 类 型 
Val result = oneLong !is Long 
tv_check result.text = "!is 的 比较 结果 是 $result" 
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isEqual = !isEqual 
» 


这 个 例子 校 验 了 变量 oneLong 是 否 为 Long 长 整 型 数 , 校 验 结果 分 别 如 图 3-21 和 图 3-22 所 示 ， 
其 中 图 3-21 展示 “is” 的 判断 结果 ， 图 3-22 展示 “!is” 的 判断 结果 。 








判断 条 件 ， ”比较 oneLong 是 否 为 长 整 型 判断 条 件 : ”比较 oneLong 是 否 非 长 整 型 
判断 结果 is 的 比较 结果 是 true 判断 结果 : lis 的 比较 结果 是 false 
图 3-21 “is” 的 判断 结果 图 3-22 “!is” 的 判断 结果 
2. 运算 符 in 和 !in 


还 有 另 一 种 特殊 的 等 式 判 断 ， 是 校 验 数组 中 是 否 存在 某 个 元 素 。 倘 若 由 Java 来 实现 ， 并 没有 
现成 的 可 用 运算 符 ， 只 能 循环 遍历 该 数组 ， 逐 个 进行 数组 元 素 的 等 式 判断 ， 无 疑 是 大 费 周章 。 现 在 
有 了 Kotlin， 则 可 直接 使 用 关键 字 in 来 校 验 ， 通 过 “变量 名 in 数组 名 ” 即 可 判断 数组 是 否 存在 等 
值 元 素 ， 通 过 “变量 名 !in 数组 名 ” 即 可 判断 数组 是 否 不 存在 等 值 元 素 。 

照例 给 出 数组 判断 代码 ， 观 察 一 下 Kotlin 如 何 实现 数组 内 部 的 等 式 判 断 ， 具 体 的 判断 代码 示 
例如 下 : 


val oneArray:IntArray = intArrayOf (1l, 2, 3, 4, 5) 
val four:Int = 4 
val nine:Int = 9 
btn equal item.setOnClickListener { 
when (count++%4) { 
0 -> 1{ 
tv_check title.text = "比较 $four 是 否 存在 数组 oneArray 中 " 
//in 用 于 判断 变量 是 否 位 于 数组 或 容器 中 , Java 判断 数组 中 是 否 存在 某 元 素 只 能 采取 循 


环 遍 历 的 方式 
val result = four in oneArray 
tv_check_result.text = "in 的 比较 结果 是 $result" 
} 
下 二 二 
tv_check _ title.text = "比较 $four 是 否 不 在 数组 oneArray 中 " 
//!in 用 于 判断 变量 是 否 不 在 数组 或 容器 中 
Val result = four !in oneArray 
tv_check_result.text = "!in 的 比较 结果 是 $result" 
} 
| 


tv_check _ title.text = "比较 Snine 是 否 存在 数组 oneArray 中 " 
//in 用 于 判断 变量 是 否 位 于 数组 或 容器 中 

Val result = nine in oneArray 

tv_check_result.text = "in 的 比较 结果 是 $result" 
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else -> { 
tv_check title.text = "比较 Snine 是 否 不 在 数组 oneArray 中 " 
//!in 用 于 判断 变量 是 否 不 在 数组 或 容器 中 


val result = nine !in oneArray 
tv_check result.text = "!in 的 比较 结果 是 $result" 


| 


以 上 数组 校 验 代 码 的 实验 结果 如 图 3-23 一 图 3-26 所 示 ， 其 中 图 3-23 展示 数组 对 four 变量 值 
进行 “in” 操 作 的 校 验 结果 ， 图 3-24 展示 数组 对 four 变量 值 进行 “!in” 操 作 的 校 验 结果 ， 图 3-25 
展示 数组 对 nine 变量 值 进行 “in” 操 作 的 校 验 结果 ， 图 3-26 展示 数组 对 nine 变量 值 进 行 “!in” 操 
作 的 校 验 结果 。 


grammar grammar 


判断 条 件 ， 比 较 4 是 否 存在 数组 oneArray 中 判断 条 件 ， 比较 4 是 否 不 在 数组 oneArray 中 








判断 结果 : in 的 比较 结果 是 true 判断 结果 : !in 的 比较 结果 是 false 

3-23 对 4 进行 “in” 操 作 的 校 验 结果 图 3-24 对 4 进行 “in” 操 作 的 校 验 结果 

grammar grammar 

判断 条 件 ; 比较 9 是 否 存在 数组 oneArray 中 判断 条 件 : 比较 9 是 否 不 在 数组 oneArray 中 

判断 结果 ; in 的 比较 结果 是 false 判断 结果 ; lin 的 比较 结果 是 true 

3-25 对 9 进行 “in” 操 作 的 校 验 结果 图 3-26 对 9 进行 “!in” 操 作 的 校 验 结果 
3.5 小 结 


本 章 介 绍 了 Kotlin 常见 的 几 种 控制 语句 的 具体 用 法 ， 包 括 条 件 分 支 的 两 种 处 理 方式 、 循 环 处 
理 的 几 个 新 特性 、 空 值 的 校 验 及 相关 操作 符 、 等 式 判断 的 两 类 判断 方式 等 。 
通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 技能 : 


(1) 学 会 运用 Kotlin 的 简单 分 支 和 多 路 分 支 语句 。 

(2) 学 会 运用 Kotlin 的 遍历 循环 和 条 件 循环 语句 。 

(3) 学 会 声明 可 空 变量 ， 并 对 可 空 变量 进行 各 种 处 理 操作 。 

(4) 学 会 进行 Kotlin 的 结构 相等 和 引用 相等 判断 ， 以 及 变量 类 型 判断 、 数 组 存在 等 值 元 素 
判断 。 





第 3 章 介 绍 了 Kotlin 的 各 种 控制 语句 , 发 现 让 和 when 语句 允许 有 返回 值 , 可 是 在 编程 世界 里 
面 ， 原 本 是 函数 才 有 返回 值 。Kotlin 这 么 一 搞 ， 难 不 成 函数 没有 用 武之 地 了 ? 恰恰 相反 ，Kotlin 不 
但 没有 削弱 函数 的 功能 ， 还 给 函数 带 来 了 不 少 新 理念 。 本 章 从 函数 的 基本 用 法 、 输 入 参数 变化 、 特 
殊 函 数 以 及 如 何 增强 系统 函数 等 几 个 方面 逐次 阐述 Kotlin 为 函数 提供 了 哪些 新 功能 。 


4.1 函数 的 基本 用 法 








一 段 相 对 独立 的 代码 块 通过 大 括号 包 起 来 ， 再 给 这 段 代 码 块 起 个 名 字 ， 便 形成 了 函数 的 雏形 。 
当然 一 个 完整 的 函数 定义 还 包括 输入 参数 与 输出 参数 两 大 要 素 , 加 上 已 有 的 函数 名 称 , 从 而 构成 有 
名 有 姓 、 能 吃 能 拉 的 数据 加 工 单位 。 下 面 就 对 函数 的 基本 定义 、 输 入 参数 以 及 输出 参数 的 类 型 定义 
做 个 概要 的 说 明 。 


4.1.1 与 Java 声明 方式 的 区 别 


第 3 章 介绍 控制 语句 时 ， 在 setOnClickListener 大 括号 里 面 写 了 大 段 的 代码 ， 这 不 但 导致 
onCreate 方法 变 得 很 腔 肿 ， 而 且 代 码 的 可 读 性 也 变 差 了 。 对 于 此 种 情况 ， 通常 的 解决 办 法 是 把 某 段 
代码 挪 到 一 个 独立 的 函数 中 ,然后 在 原 位 置 调用 该 函数 。 这 样 做 的 好 处 很 多 , 不 仅 增 强 了 代码 的 可 
读 性 ， 还 能 多 次 重复 调用 函数 。 

那么 Kotlin 对 函数 的 使 用 跟 Java 相 比 ， 有 哪些 区 别 呢 ? 先 从 最 常见 的 onCreate 方法 入 手 ， 看 
看 二 者 都 有 哪些 区 别 ， 下 面 是 Java 编写 的 onCreate 函数 代码 : 

@Override 

public void onCreate(Bundle savedInstanceState) { 
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} 
而 使 用 Kotlin 编写 的 onCreate 函数 代码 如 下 所 示 : 


override fun onCreate (savedInstanceState: Bundle?) { 


两 相对 比 ， 可 以 看 到 二 者 主要 有 以 下 几 点 区 别 : 

(1) Java 使 用 “@Override” 表 示 该 函数 重 载 父 类 的 方法 ， 而 Kotlin 使 用 小 写 的 “override” 
在 同一 行 表 达 重 载 操 作 。 

(2) Java 使 用 “public” 表 示 该 函数 是 公共 方法 ， 而 Kotlin 默认 函数 就 是 公开 的 ， 所 以 省 略 
了 关键 字 “public”。 

(3) Java 使 用 “void” 表 示 该 函数 没有 返回 参数 ， 而 Kotlin 不 存在 关键 字 “void”， 若 无 返 
回 参数 ， 则 不 用 特别 说 明 。 
(4) Kotlin 新 增 了 关键 字 “fun”, 表示 这 里 是 函数 定义 , 其 格式 类 似 于 Java 的 关键 字 “class”， 
而 Java 不 存在 关键 字 “fun”。 

(5) Java 声明 输入 参数 的 格式 为 “变量 类 型 变量 名 称 ”， 而 Kotlin 声明 输入 参数 的 格式 为 
“变量 名 称 : 变量 类 型 ”。 

(6) Kotlin 引入 了 空 安全 机 制 , 如 果 某 个 变量 允许 为 空 , 就 需要 在 变量 类 型 后 面 加 个 问号 “?”。 

其 中 第 5 点 区 别 的 说 明 参 见 第 2 章 的 “2.1.1 基本 类 型 的 变量 声明 ”， 第 6 点 区 别 的 说 明 参 见 
第 3 章 的 “3.3.2 声明 可 空 变量 ”。 

由 此 看 来 ，Kotlin 与 Java 的 函数 定义 之 间 还 有 蛮 多 差异 的 ， 其 实 不 但 差异 不 少 ， 而 且 Kotlin 
增加 了 不 少 新 功能 ， 有 待 我 们 接 下 来 仔细 探索 。 





4.1.2 输入 参数 的 格式 


Kotlin 的 函数 写法 与 Java 的 传统 写法 颇 为 不 同 ， 接 下 来 还 是 从 简单 的 函数 声明 开始 循序 渐进 
地 学 习 。 下 面 是 一 个 简单 的 函数 定义 代码 ， 既 没有 输入 参数 也 没有 输出 参数 : 
// 没 有 输入 参数 ， 也 没有 输出 参数 
fun getDinnerEmpty() { 
tv_process.text = "只 有 空 盘子 哆 " 
tv result.text = "" 
上 


这 个 既 无 入 参 也 无 出 参 的 函数 看 起 来 比较 容易 理解 。 下 面 再 给 出 一 个 增加 了 输入 参数 的 函数 
定义 : 
// 只 有 输入 参数 


fun getDinnerInput (egg:Int, leek:Double, water:String, shell:Float) { 
tv_process.text = "食材 包括 : 两 个 鸡蛋 、 一 把 韭菜 、 几 标清 水 " 
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tV_result.text = "" 
和 


只 要 学 习 了 第 2 章 的 基本 数据 类 型 的 用 法 ， 这 个 存在 入 参 的 函数 也 就 易于 接受 。 在 上 面 代码 
的 基础 上 ， 增 加 允许 第 三 个 入 参 为 空 ， 则 相应 的 Kotlin 代码 改写 如 下 : 
// 输 入 参数 存在 空 值 
fun getDinnerCanNull (egg:Int, leek:Double, water:String?, shell:Float) { 
tv_process.text = if (water!=nul1) "食材 包括 : 两 个 鸡蛋 、 一 把 韭菜 、 几 标清 水 "else 
"没有 水 没 法 做 汤 啦 " 
tv result.text = "" 


} 


补充 的 代码 修改 是 在 变量 类 型 后 面 加 上 问号 ， 表 示 该 参数 可 以 为 空 。 现在 有 了 定义 好 的 函数 ， 
若 要 在 Kotlin 代码 中 调用 它们 ， 那 可 一 点 都 没 变 化 ， 原 来 在 Java 中 怎么 调用 ， 在 Kotlin 中 一 样 采 
取 “ 函 数 名 称 (参数 列表 )” 的 形式 进行 调用 。 调 用 上 述 三 个 函数 的 Kotlin 代码 举例 如 下 : 

btn_input empty.setOnClickListener { getDinnerEmpty() } 

btn input param.setOnClickListener { getDinnerInput (2，1111.1111， "水 林 森 "， 
10000f) } 

btn_ input null.setOnClickListener { getDinnerCanNull (2, 1111.1111, null, 
10000f) } 


以 上 通过 三 个 按钮 的 点 击 事件 分 别 调用 三 个 函数 ， 函 数 调用 效果 分 别 如 图 4-1 一 图 4-3 所 示 ， 
其 中 图 4-1 展示 调用 函数 getDinnerEmpty 的 结果 ， 图 4-2 展示 调用 函数 getDinnerInput 的 结果 ， 图 
4-3 展示 调用 函数 getDinnerCanNull 的 结果 。 


grammar 


grammar grammar 


函数 过 程 : 食材 包括 : 两 个 鸡蛋 、 一 把 韭菜 、 
几 村 清水 没有 水 没 法 做 汤 啦 


函数 过 程 : 只 有 空 盘子 哟 
函数 结果 函数 结果 : 





图 4-1 没有 输入 参数 的 界面 图 42 存在 输入 参数 的 界面 图 4-3 输入 参数 存在 空 值 的 界面 


4.1.3 ”输出 参数 的 格式 


4.1.2 小 节 讨 论 了 存在 输入 参数 的 情况 ， 如 果 函 数 需要 返回 输出 参数 ， 又 该 如 何 是 好 ? 在 Java 
代码 中 ， 函 数 的 返回 参数 类 型 在 函数 名 称 前 面 指定 ， 形 如 “public int main(.…)”， 但 在 Kotlin 中 ， 
返回 参数 类 型 却 在 右 括号 后 面 指定 , 形 如 “fun main(.…):Int”。 对 于 习惯 了 Java 的 开发 者 而 言 , Kotlin 
的 这 种 写法 着 实 别扭 ,为 了 方便 记忆 , 我 们 姑且 把 函数 当 作 一 种 特殊 的 变量 , 那么 定义 函数 就 跟 定 
义 变量 是 同一 种 写法 。 

比如 Kotlin 定义 一 个 整 型 变量 ， 声 明代 码 如 下 所 示 : 


vax TTnt 


再 看 看 Kotlin 如 何 定 义 一 个 函数 ， 具 体 的 函数 声明 代码 如 下 : 
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fun main () :Int 


如 此 一 来 ， 功 能 定义 var 对 fun， 参 数 类 型 Int 对 Int， 唯 一 的 区 别 便 是 函数 定义 多 了 一 对 括号 
以 及 括号 内 部 的 输入 参数 。 也 许 这 只 是 巧合 , 但 是 偶然 中 有 必然 ,Kotlin 设计 师 的 初衷 正 是 把 函数 
作为 一 个 特殊 的 变量 ， 关 于 这 点 在 本 书后 面 还 会 再 次 提 到 。 

既然 函数 被 当 作 一 种 特殊 的 变量 ， 同 时 每 个 变量 都 有 变量 类 型 ， 假 如 函数 存在 返回 参数 ， 那 
么 自然 把 返回 参数 的 类 型 作为 该 函数 的 变量 类 型 ， 要 是 函数 不 存在 返回 参数 ， 也 就 是 Java 中 的 返 
回 void， 那 该 怎么 办 ? 这 里 得 澄清 一 下 ，Java 使 用 void 表示 不 存在 返回 参数 ， 然 而 Kotlin 的 返 区 
参数 是 一 定 存在 的 ， 即 使 开发 者 不 声明 任何 返回 参数 ，Kotlin 函数 也 会 默认 返回 一 个 Unit 类 型 的 
对 象 。 

比如 前 面 的 函数 定义 getDinnerEmpty0， 表 面 上 看 没有 返回 任何 参数 ， 其 实 它 的 真正 写法 是 下 
面 的 代码 : 

//Unit 类 型 表示 没有 返回 参数 ， 也 可 直接 省 略 Unit 声明 

fun getDinnerUnit():Unit { 

tv_process.text = "只 有 空 盘 子 哟 " 


tv_result,.text = "" 


} 


因为 Unit 类 型 的 参数 无 须 开 发 者 返回 具体 的 值 ,所 以 Kotlin 代码 往往 把 函数 名 称 后 面 的 :Unit” 
直接 省 咯 掉 了 。 增 加 Unit 类 型 的 目的 是 让 函数 定义 完全 符合 变量 定义 的 形式 。 若 函数 需要 具体 的 
输出 参数 ， 则 一 样 要 在 函数 未 尾 使 用 关键 字 “return” 来 返回 参数 值 。 下 面 的 代码 演示 如 何在 函数 
中 返回 一 个 字符 串 对 象 : 

// 只 有 输出 参数 

fun getDinnerOutput () :String { 
tv_process.text = "只 有 空 盘子 哆 " 
var dinner:String = " 巧 妇 难为 无 米 之 炊 ， 汝 速 去 买 菜 " 


return dinner 


} 


有 了 以 上 的 各 种 说 明 铺垫 ， 现 在 定义 一 个 同时 包含 入 参 和 出 参 的 函数 ， 写 起 代码 便 顺 理 成 章 
了 。 如 下 所 示 的 代码 通过 判断 各 种 输入 食材 ， 从 而 输出 一 道 色 香味 俱全 的 菜 看 : 


// 同 时 具备 输入 参数 和 输出 参数 
fun getDinnerFull (egg:Int, leek:Double, water:String?, shell:Float):String { 
tv_process.text = if (water!=null) "食材 包括 : 两 个 鸡蛋 、 一 把 韭菜 、 几 标清 水 " else 
"没有 水 没 法 做 汤 啦 " 
var dinner:String = "两 个 黄 本 鸣 浴 柳 ，\n 一 行 白 获 上 青天 。\n 窗 含 西 岭 千 秋 雪 ，\n 门 泊 
东 吴 万 里 船 。" 
return dinner 


b 
存在 具体 返回 参数 的 函数 ， 调 用 方式 与 原来 相 比 并 无 区 别 ， 以 下 直接 给 出 示例 代码 : 


btn output empty.setOnClickListener { getDinnerUnit() } 
btn output param.setOnClickListener { tv result.text=getDinnerOutput() } 
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btn full param.setOnClickListener { tv result.text=getDinnerFull]l (2, 
1111.1111，" 水 林 森 "，10000f) } 


上 述 三 个 按钮 的 点 击 事件 分 别 调用 三 个 包含 返回 参数 的 grammar 
函数 ， 函 数 调用 效果 分 别 如 图 4-4 一 图 4-6 所 示 ， 其 中 图 4-4 
展示 调用 函数 getDinnerUnit 的 结果 ， 图 4-5 展示 调用 函数 
getDinnerOutput 的 结果 ， 图 4-6 展示 调用 函数 getDinnerFull 
的 结果 。 图 44 没有 输出 参数 的 界面 


没有 水 没 法 做 汤 啦 





grammar 


函数 过 程 :食材 包括 : 两 个 鸡蛋 、 一 把 韭菜 、 
grammar 几 标 清水 


函数 结果 : 两 个 黄酮 鸣 以 柳 ， 
一 行 白 路 上 青天 。 


窗 含 西 岭 千秋 雪 ， 
函数 结果 : 巧 妇 难 为 无 米 之 炊 ， 涩 速 去 买 菜 门 泊 东 吴 万 里 船 。 


函数 过 程 : 只 有 空 盘子 哟 





4-5 存在 输出 参数 的 界面 图 4-6 输入 参数 和 输出 参数 齐全 的 界面 


4.2 输入 参数 的 变化 


前 面 介绍 了 Kotlin 对 函数 的 基本 用 法 ， 包 括 函 数 的 定义 、 输 入 参数 的 声明 、 输 出 参数 的 声明 
等 ， 这 些 足 够 应 付 简单 的 场合 了 。 当 然 ， 倘 若 一 门 新 语言 仅仅 满足 于 这 些 导 虫 小 技 ， 那 也 实在 没 什 
么 前 途 。 既 然 Kotlin 志 在 取 代 Java， 就 必须 练 成 Java 所 不 具备 的 功夫 。 本 节 便 从 函数 的 输入 参数 
着 手 ， 谈 谈 Kotlin 对 输入 参数 的 改进 与 增强 之 处 。 


4.2.1 默认 参数 


首先 复习 一 下 如 何 声明 函数 的 输入 参数 ， 比 如 回答 “中 国 的 伟大 发 明 有 哪些 ? ”这 个 问题 需 
要 定义 一 个 函数 , 根据 输入 的 几 个 发 明 名 称 将 这 几 个 发 明 拼接 成 完整 的 答案 。 具体 的 函数 定义 举例 
如 下 : 





fun getFourBig(general:String, first:String, second:String, third:String, 
fourth:String) :String { 
var answer:String = "$general: $first, $second, $third, $fourth" 
return answer 


该 函数 的 目的 是 获取 中 国 四 大 发 明 的 回答 ， 你 可 以 输入 中 国 古 代 的 四 大 发 明 ， 也 可 以 输入 外 
国 留学 生 票 选 的 中 国 现代 四 大 发 明 。 两 种 输入 对 应 的 函数 调用 都 很 简单 ,只 要 按照 参数 顺序 依次 输 
入 四 大 发 明 的 名 称 即 可 ， 调 用 代码 如 下 所 示 : 
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var isodd = true // 如 果 从 初始 赋值 中 能 够 知道 变量 类 型 ， 就 无 须 显 式 指定 该 变量 的 类 型 
btn input manual.setOnClickListener { 
tv four answer.text = if (is0dd) getFourBig(" 古 代 的 四 大 发 明 ", "造纸 术 ", "印刷 术 "， 
"火药 ", "指南 针 ") else getFourBig ("现代 的 四 大 发 明 ", "高 铁 ", "网 购 ", "移动 支付 ", "共享 单车 ") 
isodd = !isodd 
1 


以 上 演示 代码 的 运行 结果 如 图 4-7 和 图 4-8 所 示 ， 其 中 图 4-7 所 示 为 奇数 次 点 击 时 显示 古代 四 
大 发 明 的 界面 ， 图 4-8 所 示 为 偶数 次 点 击 时 显示 现代 四 大 发 明 的 界面 。 
可 是 这 么 调用 函数 不 够 智能 ， 因 为 中 国 古代 的 四 大 发 明 人 尽 皆 知 ， 小 学 生 都 知道 ， 何 必 还 得 
每 次 都 手工 输入 呢 ? 于 是 Kotlin 引入 了 默认 参数 的 概念 ， 允 许 在 定义 函数 时 直接 指定 输入 参数 的 
默认 值 。 如 果 调 用 函数 时 没有 给 出 某 参数 的 具体 值 ， 系 统 就 自动 对 该 参数 赋予 默认 值 ， 从 而 免 去 每 
次 都 要 手工 赋值 的 麻烦 。 默认 参数 的 写法 也 很 简单 ,只 需 在 声明 输入 参数 时 在 其 后 面 加 上 等 号 及 其 
默认 值 ， 详 细 的 函数 定义 代码 如 下 所 示 : 








mm 





fun getFourBigDefault (general:String,， first:String=" 造 纸 术 "，second:String=" 
印刷 术 "，third:String=" 火 药 "，fourth:String=" 指 南 针 ") :String { 


Var answer:String = "$general: $first, $second, $third, $fourth" 
return answer 


} 
自从 有 了 默认 参数 ， 这 下 函数 调用 简单 多 了 ， 就 算 开 发 者 一 时 脑袋 糊涂 想 不 起 来 四 大 发 明 ， 
也 能 毫 无 压力 地 敲 写 代码 。 不 信 请 看 下 面 的 调用 代码 : 


btn input default.setOnClickListener { tv four answer.text= 
getFourBigDefault ("古代 的 四 大 发 明 ") } 


简化 后 的 代码 运行 界面 如 图 4-9 所 示 ， 可 见 默认 参数 已 经 派 上 用 场 了 。 


grammar grammar grammar 


题目 : 中 国 的 伟大 发 明 有 哪些 ? 
答案 ， ”古代 的 四 大 发 明 ; 造纸 术 ， 印 刷 
术 ， 火 药 ， 指 南 针 


中 国 的 伟大 发 明 有 哪些 ? 
古代 的 四 大 发 明 ; 造纸 术 ， 印 刷 
术 ， 火 药 ， 指 南 针 





图 4-7 展示 古代 的 四 大 发 明 图 4-8 ”展示 现代 的 四 大 发 明 图 4-9 运用 默认 参数 的 效果 图 


4.2.2 ”命名 参数 


如 果 不 满意 参数 的 默认 值 ， 也 可 在 调用 函数 时 输入 新 的 值 ， 例 如 四 大 发 明 的 默认 值 不 包含 它 
们 的 发 明 者 ， 现 在 想 增加 显示 造纸 术 的 发 明 者 蔡伦 ， 则 调用 getFourBigDefault 函数 时 ， 注 意 给 第 
二 个 参数 填写 指定 的 描述 文字 ， 代 码 示例 如 下 : 


btn input part.setOnClickListener { tv four answer.text=getFourBigDefault(" 
古代 的 四 大 发 明 ", "蔡伦 发 明 的 造纸 术 ") } 


使 用 新 值 替 换 默 认 值 的 函数 调用 效果 如 图 4-10 所 示 ， 可 见 第 一 个 发 明 的 描述 从 “造纸 术 ” 变 
成 了 “蔡伦 发 明 的 造纸 术 ”。 
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有 时 想 要 变更 的 参数 并 非 第 一 个 默认 参数 ， 比 如 第 二 个 默认 参数 的 “印刷 术 ”， 虽 然 印 刷 术 
起 源 于 中 国 是 毫 无 疑义 的 , 但 是 韩国 声称 是 他 们 的 古人 发 明了 金属 活字 印刷 , 德国 也 有 确凿 证 据 证 
明 是 古 腾 堡 发 明了 活字 印刷 机 ,这些 言 论 容易 误导 外 人 以 为 中 国 只 是 发 明了 膨 版 印刷 术 而 已 。 事 实 
上 不 光 周 版 印刷 的 发 明 属 于 中 国 ， 就 连 活字 印刷 都 是 北宋 的 毕 异 发 明 的 ， 亡 以 为 了 正本 清 源 , “ 印 
刷 术 ”的 名 称 可 改 为 影响 力 更 大 的 “活字 印刷 ”。 然 而 “印刷 术 ” 在 函数 声明 里 面 排 在 “造纸 术 ” 
后 面 ， 英 非 为 了 给 “印刷 术 ” 改 名 ， 还 得 把 前 面 的 “造纸 术 ” 照 抄 一 遍 ? 

为 了 解决 这 个 不 合理 的 地 方 , Kotlin 又 引进 了 命名 参数 的 概念 , 说 的 是 调用 函数 时 可 以 指定 某 
个 参数 的 名 称 及 其 数值 ， 具 体格 式 形 如 “参数 名 = 参数 值 ”这 样 。 就 前 述 的 给 “印刷 术 ” 改 名 而 言 ， 
具体 到 Kotlin 编码 上 面 ， 可 参见 以 下 的 示例 代码 : 


btn input name.setOnClickListener { tv four answer.text=getFourBigDefault(" 


古代 的 四 大 发 明 ", second=" 活 字 印 刷 ") } 


由 此 可 见 ， 上 面 代 码 使 用 了 命名 参数 的 表达 式 “second=" 活 字 印 刷 "”， 该 表达 式 实现 了 给 指 
定 参数 赋值 的 功能 ， 图 4-11 展示 运用 命名 参数 的 演示 界面 。 











grammar grammar 


题目 : 中 国 的 伟大 发 明 有 哪些 ? 题目 : 中 国 的 伟大 发 明 有 哪些 ? 


答案 :古代 的 四 大 发 明 : 蔡伦 发 明 的 造纸 答案 :古代 的 四 大 发 明 : 造纸 术 ， 活 字 印 
术 ， 印 刷 术 ， 火 药 ， 指 南 针 刷 ， 火 药 ， 指 南 针 





图 4-10 使 用 新 值 蔡 换 默认 值 的 效果 图 图 4-11 运用 命名 参数 的 效果 图 


4.2.3 ”可 变 参 数 


默认 参数 结合 命名 参数 的 写法 至 此 告 一 段落 。 不 料 吃 瓜 群 众 有 话说 ， 咱 们 中 国 历史 悠久 、 地 
大 物 博 ， 伟 大 发 明 何止 四 大 发 明 呢 ? 譬如 丝绸 、 次 器、 茶叶 ， 每 个 擒 出 来 都 是 响当当 的 物件 ， 其 地 
位 在 古代 西方 人 眼 里 ， 好 比 现代 中 国人 爱 买 的 LV、 劳 力士、 欧莱雅 。 所 以 中 国 的 伟大 发 明 可 不 能 
只 限于 四 大 发 明 ， 必 须 改 成 允许 随时 添加 的 ， 想 加 几 个 就 加 几 个 。 

这 种 随时 添加 的 概念 对 应 于 函数 定义 里 面 的 可 变 参数 , 在 Java 体系 中 , 可 变 参 数 采用 “Object.… 
args” 的 形式 ; 在 Kotlin 体系 中 ， 新 增 了 关键 字 vararg， 表 示 其 后 的 参数 个 数 是 不 确定 的 。 以 可 变 
的 字符 串 参 数 为 例 ，Java 的 写法 为 “String... args”， 而 Kotlin 的 写法 为 “vararg args: String?”。 
函数 内 部 在 解析 的 时 候 ，Kotlin 会 把 可 变 参数 当 作 一 个 数组 ， 开 发 者 需要 循环 取出 每 个 参数 值 进行 
处 理 ， 对 应 的 Kotlin 演示 代码 如 下 所 示 : 

fun getFourBigVararg (general:String，first:String=" 造 纸 术 "，second:String=" 
印刷 术 "，third:String=" 火 药 "， fourth:String=" 指 南 针 "，vararg otherRrray: 

String?) :String { 











Var answer:String = "$general: $first, $second, $third, $fourth" 
// 循 环 取出 可 变 参数 包含 的 所 有 字段 
for (item in otherRArray) { 

answer = "$answer, $item" 


| 
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return answer 


这 下 好 了 ， 同 一 个 函数 既 可 以 输入 四 大 发 明 ， 又 可 以 输出 七 大 发 明 ， 哪 天 你 给 弄 个 十 大 发 明 
也 是 允许 的 。 下 面 是 带 有 可 变 参 数 的 函数 调用 代码 : 
btn param vararg.setOnClickListener { 
// 可 变 参数 输入 了 三 个 字符 串 ， 即 "丝绸 "," 瓷 器", "茶叶 " 
tv_four answer.text = if (is0dd) getFourBigVararg ("古代 的 四 大 发 明 ") else 
getFourBigVararg ("古代 的 七 大 发 明 ", "造纸 术 ", "印刷 术 ", "火药 ", "指南 针 ", "丝绸 ", "瓷器 "," 茶 
时 中 
isodd = !isodd 
} 
引入 可 变 参数 的 函数 调用 结果 如 图 4-12 所 示 ， 可 见 四 大 
发 明 变 成 了 七 大 发 明 。 Sa 
话说 中 国文 化 博大 精深 ,除了 物质 上 的 发 明 外 ， 另 有 不 少 题目 ; 中 国 的 伟大 发 明 有 哪些 ? 
技艺 上 的 发 明 , 例如 国画 、 中 医 、 武术 等 , 哪个 不 是 国之 瑰宝 ? 答案 ， ”古代 的 七 大 发 明 ; 造纸 术 ， 印 刷 
因此 ， 可 变 参 数 也 要 支持 输入 这 些 技巧 性 的 发 明 ， 当 然 为 了 跟 Pe lh 
物质 性 的 发 明 区 分 开 , 最 好 分 门 别 类 ,把 物质 性 的 发 明 分 为 一 
组 ， 技 巧 性 的 发 明 分 为 一 组 。 人 
如 此 一 来 ， 可 变 参数 就 成 了 可 变 的 数组 参数 ， 同 样 声明 数组 参数 时 也 要 加 上 vararg 前 级 ， 告 
诉 编译 器 后 面 的 数组 个 数 是 变化 的 。 对 应 的 函数 声明 代码 修改 如 下 : 
fun getFourBigArray (general:String，first:String=" 造 纸 术 "，second:String=" 印 
刷 术 "，third:String=" 火 药 "， fourth:String=" 指 南 针 "，vararg otherArray: 
Array<String>) :String { 
var answer:String = "$general: $first, $second, $third, $fourth" 
// 先 遍历 每 个 数组 
for (array in otherArray) { 
// 再 遍历 某 个 数组 中 的 所 有 元 素 


for (item in array) { 














answer = "$answer, $item" 
} 
return answer 
对 于 数组 形式 的 可 变 参 数 ， 进 行 函 数 调用 时 得 按照 数组 参数 输入 ， 示 例 代码 如 下 : 
btn param array.setOnClickListener { 
// 可 变 参数 输入 了 两 个 数组 变量 ， 每 个 数组 都 使 用 arrayOf 定义 
tv_four answer.text = if (is0dd) getFourBigArray ("古代 的 四 大 发 明 ") else 
getFourBigArray ("古代 的 N 大 发 明 ", "造纸 术 ", "印刷 术 ", "火药 "，, "指南 针 ", arrayof ("丝绸 ", " 瓷 
器 ", "茶叶 ") ,arrayof ("国画 ", "中 医 ", "武术 ") ) 
isodd = !isodd 





} 
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采取 数组 变量 作为 可 变 参数 的 函数 调用 结果 如 图 
4-13 所 示 ， 可 见 根据 输入 信息 一 共 展 示 了 中 国 古 代 的 
10 个 重要 发 明 。 








总 结 一 下 , Kotlin 引入 了 默认 参数 的 概念 , 并 加 以 题目 : 中 国 的 伟大 发 明 有 哪些 ? 
扩展 允许 通过 命名 参数 指定 修改 某 个 参数 值 ， 而 Java 答案 : 人 过 经 术 ， 有 
是 不 存在 默认 参数 概念 的 。 另 外 ，Kotlin 对 Java 的 可 茶叶 ， 国 画 ， 中 医 ， 人 





变 参 数 功能 进行 了 增强 ， 不 但 支持 普通 类 型 的 可 变 参 


图 4-13 ”使 用 数组 变量 作为 可 变 参 数 的 效果 图 
数 ， 而 且 支 持 数组 类 型 的 可 变 参数 。 


4.3” 几 种 特殊 函数 


4.2 节 介绍 了 Kotlin 对 函数 的 输入 参数 所 做 的 增强 之 处 , 其 实 函 数 这 块 Kotlin 还 有 好 些 重大 改 
进 ， 集 中 体现 在 几 类 特殊 函数 ， 比 如 泛 型 函数 、 内 联 函 数 、 简 化 函数 、 尾 递归 函数 、 高 阶 函数 等 ， 
因此 本 节 就 对 这 几 种 特殊 函数 进行 详细 说 明 。 


4.3.1 泛 型 函数 


按照 之 前 的 例子 ， 函 数 的 输入 参数 类 型 必须 在 定义 函数 时 就 要 指定 ， 可 是 有 时 候 参数 类 型 是 
不 确定 的 ， 只 有 在 调用 函数 时 方 能 知晓 具体 类 型 ， 如 此 一 来 要 怎样 声明 函数 呢 ? 其 实在 第 2 章 的 
“2.2.1 数组 变量 的 声明 ”里 面 就 遇 到 了 类 似 的 情况 ， 当 时 为 了 采取 统一 的 格式 声明 基本 类 型 的 数 
组 变量 ， 使 用 “Array< 变 量 类 型 >” 来 声明 数组 变量 ， 并 通过 arrayOf 函数 获得 数组 变量 的 初始 值 ， 
具体 代码 如 下 所 示 : 

var int array:Array<Int> = arrayOf<Int>(1，2，3) 

Var long array:Array<Long> = arrayOf<Long> (1，2，3) 

Var float array:Array<Float> = arrayOf<Float>(1.0f, 2.0f, 3.0f) 


注意 到 尖 插 号 内 部 指定 了 数组 元 素 的 类 型 ， 这 正 是 泛 型 的 写法 “<***>”。 由 “Array< 变 量 类 
>” 声 明 而 来 的 变量 可 称 作 泛 型 变量 ， 至 于 等 号 后 面 的 arrayOf 便 是 本 小 节 要 说 的 泛 型 函数 。 
定义 泛 型 函数 时 ， 得 在 函数 名 称 前 面 添加 “<T> ”， 表 示 以 T 声 明 的 参数 (包括 输入 参数 和 输 
出 参数 ) ， 其 参数 类 型 必须 在 函数 调用 时 指定 。 下 面 举 个 泛 型 函数 的 定义 例子 ， 目 的 是 把 输入 的 可 
变 参数 逐个 拼接 起 来 ， 并 返回 拼接 后 的 字符 串 ， 示 例 代码 如 下 : 
//Kotlin 允许 定义 全 局 函数 ， 即 函数 可 在 单独 的 kt 文件 中 定义 ， 然 后 其 他 地 方 也 能 直接 调用 
fun <T> appendString (tag:String，vararg otherInfo: T?) :String { 
Var str:String = "Stag: " 
// 遍 历 可 变 参数 中 的 泛 型 变量 ， 将 其 转换 为 字符 串 再 拼接 到 一 起 
for (item in otherInfo) { 
str = "S$strS$fitem.toString()}，" 





} 
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return str 


} 
调用 上 面 的 泛 型 函数 appendString， 就 跟 调 用 arrayOf 方法 一 样 ， 只 需 在 函数 名 称 后 面 添加 “< 
变量 类 型 >” 即 可 ， 然 后 输入 参数 照 原样 填写 。 以 下 是 appendString 函数 的 调用 代码 例子 : 


var count = 0 
btn vararg generic.setOnClickListener { 
tv_function result.text = when (countg3) { 
0 -> appendString<String> ("古代 的 四 大 发 明 ", "造纸 术 ", "印刷 术 ", "火药 "，" 
指南 针 ") 
1 -> appendstring<Int>(" 小 于 10 的 素数 ",2,3,5,7) 
else -> appendString<Double>(" 烧 钱 的 日 子 ",5.20,6.18,11.11,12.12) 
} 
count++ 


有 


泛 型 函数 appendString 的 演示 结果 如 图 4-14 一 图 4-16 所 示 , 其 中 图 4-14 展示 输入 字符 串 变量 
的 结果 界面 ， 图 4-15 展示 输入 整 型 变量 的 结果 界面 ， 图 4-16 展示 输入 双 精 度 变量 的 结果 界面 。 


grammar grammar grammar 


题目 : 脑筋 急 转 弯 题目 : 脑筋 急 转 弯 题目 : 脑筋 急 转 论 
答案 ;古代 的 四 大 发 明 : 造纸 术 ， 印 刷 本 答案 : 烧 钱 的 日 子 ，5.2，6.18， 
术 ， 闵 药 ， 指南针 答案 : 。 小 于 10 的 素数 : 2，3，5，7， 人 





图 4-14 泛 型 函数 输入 字符 串 图 4-15 泛 型 函数 输入 整 型 数 图 4-16 泛 型 函数 输入 双 精 度数 
的 效果 的 效果 的 效果 


4.3.2 ”内 联 函 数 


注意 到 前 面 定义 泛 型 函数 appendString 时 ， 是 把 它 作为 一 个 全 局 函数 ， 也 就 是 在 类 外 面 定 义 ， 
而 不 在 类 内 部 定义 。 因为 类 的 成 员 函 数 依赖 于 类 ， 只 有 泛 型 类 (又 称 模板 类 ) 才能 拥有 成 员 泛 型 函 
数 ， 而 普通 类 是 不 允许 定义 泛 型 函数 的 ， 否 则 编译 器 会 直接 报错 。 不 过 有 个 例外 情况 ， 如 果 参 数 类 
型 都 是 继承 自 某 种 类 型 , 那么 允许 在 定义 函数 时 指定 从 这 个 基 类 泛 化 开 , 凡是 继承 自 该 基 类 的 子 类 ， 
都 可 以 作为 输入 参数 进行 函数 调用 ， 反 之 则 无 法 调用 函数 。 

举 个 例子 ，Int、Float 和 Double 都 继承 自 Number 类 ， 但 是 假如 定义 一 个 输入 参数 形式 为 
setArrayNumber(array:Array<Number>) 的 函数 ， 它 并 不 接受 Array<Int> 或 者 Array<Double> 的 入 参 。 
如 果 要 让 该 方法 同时 接收 整 型 和 双 精 度 的 数组 入 参 ， 就 得 指定 泛 型 变量 T 来 自 于 基 类 Number， 即 
将 “<T>” 改 为 “<reifiedT :Number>”， 同 时 在 fun 前 面 添加 关键 字 inline， 表 示 该 函数 属于 内 联 
函数 。 

内 联 函数 在 编译 的 时 候 会 在 调用 处 把 该 函数 的 内 部 代码 直接 复制 一 份 , 调用 10 次 就 会 复制 10 
份 ， 而 非 普 通 函数 那样 仅仅 提供 一 个 函数 的 访问 地 址 。 下 面 是 上 述 例子 的 内 联 函数 定义 代码 : 

// 该 函数 既 不 接收 Array<Int>， 也 不 接收 Array<Double>， 只 好 沦 为 孤 家 寡人 
fun setArrayNumber (array:Array<Number>) { 
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var str:String = "数组 元 素 依次 排列 : " 
for (item in array) 1{ 
Str = str + item-toStzing() + wy " 
} 
tv_function result.text = str 
| 


// 只 有 内 联 函数 才 可 以 被 具体 化 
inline fun <reified T : Number> setArrayStr(array:Array<T>) { 


var str:String = "数组 元 素 依次 排列 : " 
for (item in array) { 
Str = Str + item.toString() 十 ", " 
} 
tv_function result.text = str 
} 


以 上 的 泛 型 函数 兼 内 联 函 数 setArrayStr 在 定义 的 时 候 稍 显 麻烦 , 不 过 外 部 的 调用 方式 没有 变化 ， 
依旧 在 函数 名 称 后 面 补充 表达 式 “< 变 量 类 型 >”。 该 内 联 函 数 的 调用 代码 示例 如 下 : 
Var int array:Array<Int> = arrayof (1, 2, 3) 
Var float array:Array<Float> = arrayOf (1.0f, 2.0f, 3.0f) 
Var double array:Array<Double> = arrayOf (11.11, 22.22, 33.33) 
//Kotlin 进行 函数 调用 时 ， 要 求 参数 类 型 完全 匹配 。 所 以 即使 Int 继承 自 Number 类 ， 也 不 能 
调用 setArrayNumber 方法 传送 Int 类 型 
//btn_generic number.setOnClickListener { setArrayNumber (int array) } 
btn generic number.setOonClickListener { 
when (counts3) { 
0 -> SetRrrayStr<Int> (int_array) 
1 -> setRrrayStr<Float> (float_array) 
else -> setRrrayStr<Double> (double array) 
} 
count++ 


4.3.3 简化 函数 


在 “4.1.3 输出 参数 的 格式 ” 中 提 到 了 可 将 函数 当 作 一 种 特殊 的 变量 ， 既 然 变量 通过 等 号 赋值 ， 
那么 函数 也 允许 使 用 等 号 对 输出 参数 赋值 。 具 体 地 说 ， 如 果 一 个 函数 的 表达 式 比 较 简单 ， 一 两 行 代 
码 就 可 以 搞定 ， 那 么 Kotlin 允许 使 用 等 号 代替 大 括号 。 

例如 ， 数 学 上 存在 计算 n! 的 阶乘 函数 ， 大 家 都 知道 5!=5*4*3*2*1， 这 个 阶乘 函数 使 用 Kotlin 
书写 的 代码 格式 如 下 所 示 : 

fun factorial(n:Int) :Int { 

1 (<= Tn 
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else n*factorial (n-1) 
} 


可 以 看 到 ,阶乘 函数 类 似 Java 中 的 “判断 条 件 ? 取 值 A: 取 值 B” 三 元 表达 式 ， 只 不 过 内 部 递归 
调用 函数 自身 而 已 。 既 然 Kotlin 把 函数 当 作 一 种 特殊 变量 ， 则 允许 通过 等 号 给 函数 这 个 变量 进行 
赋值 ， 据 此 可 将 阶乘 函数 代码 使 用 等 号 改写 如 下 : 


fun factorial(n:Int):Int = if (n <= 1) n else n*factorial (n-1) 


4.3.4” 尾 递归 函数 


4.3.3 小 节 的 阶乘 函数 只 是 一 个 普通 的 递归 函数 ，Kotlin 体系 还 存在 一 种 特殊 的 递归 函数 ， 名 
叫 尾 递归 函数 ， 它 指 的 是 函数 末尾 的 返回 值 重 复 调用 了 自身 函数 。 此 时 要 在 fun 前 面 加 上 关键 字 
tailrec， 告 诉 编译 器 这 是 一 个 尾 递 归 函 数 ， 则 编译 器 会 相应 进行 优化 ， 从 而 提高 程序 性 能 。 

比如 求 余弦 不 动 点 ， 即 可 通过 尾 递归 函数 来 实现 ， 下 面 是 具体 的 实现 代码 例子 : 

// 如 果 函 数 尾部 递归 调用 自身 ， 那 么 可 加 上 关键 字 tailrec 表示 这 是 一 个 尾 递归 函数 

// 此 时 编译 器 会 自动 优化 递归 ， 即 用 循环 方式 代替 递归 ， 从 而 避免 栈 溢出 的 情况 

// 比 如 下 面 这 个 求 余弦 不 动 点 的 函数 就 是 尾 递归 函数 

tailrec fun findFixPoint (x: Double = 1.0): Double 

= if (x == Math.cos(x)) x else findFixPoint (Math.cos (x)) 


4.3.5 ”高 阶 函 数 


前 面 多 次 提 到 函数 被 Kotlin 当 作 特殊 变量 ， 包 括 函 数 声 明 采 取 跟 变量 声明 一 样 的 形式 “名 称 : 
类 型 ”， 以 及 简化 函数 允许 直接 用 等 号 连接 函数 体 等 ， 本 节 最 后 讲述 的 内 容 则 是 把 A 函数 作为 B 
函数 的 输入 参数 ， 就 像 普通 变量 一 样 参与 B 函数 的 表达 式 计算 。 此 时 ， 因 为 B 函数 的 入 参 内 嵌 了 
A 函数 ， 故 而 B 函数 被 称 作 高 阶 函数 ， 对 应 的 A 函数 则 为 高 阶 函数 的 函数 参数 ， 又 称 函数 变量 。 

为 了 解释 地 更 加 清楚 些 ， 接 下 来 看 一 个 例子 。 对 于 一 个 数组 变量 ， 若 想 求 得 该 数组 元 素 的 最 
大 值 ， 则 可 以 调用 该 数组 的 max 方法 。 现 在 有 一 个 字符 串 数 组 ， 类 型 为 Array<String>， 倘 车 调 用 
该 数组 的 max 方法 ， 返 回 的 并 非 最 长 的 字符 串 ， 而 是 按 首 字母 排序 在 字母 表 最 靠 后 的 那个 字符 串 。 
比如 有 个 字符 串 数组 为 arrayOf"How", "do", "you", "do", "Tm ", "Fine"), 调用 max 方法 获得 的 字 
符 串 为 “you”， 而 不 是 长 度 最 长 的 那个 字符 串 “Im  ”。 

当然 ， 也 可 以 写 一 个 单独 的 函数 专门 判断 字符 串 长 度 ， 然 而 要 是 哪 天 需要 其 他 比较 大 小 的 算法 ， 
难道 又 得 再 写 一 个 全 新 的 比较 函数 ? 显然 这 么 做 的 代价 不 菲 ， 所 以 Kotlin 引入 了 高 阶 函 数 这 个 秘密 
武器 ， 直 接 把 这 个 比较 算法 作为 参数 传 进来 ， 由 开发 者 在 调用 高 阶 函 数 时 再 指定 具体 的 算法 函数 。 
就 获取 字符 串 数组 内 部 的 最 大 值 而 言 ， 实 现 该 功能 框架 的 高 阶 函 数 代 码 如 下 所 示 : 

// 人 允许 将 函数 表达 式 作为 输入 参数 传 进来 ， 就 形成 了 高 阶 函 数 ， 这 里 的 greater 函数 就 像 是 个 变量 

//greater 函数 有 两 个 输入 参数 ， 返 回 布尔 型 的 输出 参数 

// 如 果 第 一 个 参数 大 于 第 二 个 参数 ， 就 认为 greater 返回 true， 否 则 返回 false 


fun <T> maxCustom(array: Array<T>, greater: (T, T) -> Boolean): T? { 








var max: T? = null 
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for (item in array) 
if (max == null || greater(item，max) ) 
max = item 
return max 


1 


上 面 高 阶 函 数 的 第 二 个 参数 就 是 一 个 函数 变量 ， 其 中 变量 名 称 为 greater, 冒号 后 面 的 “(T, T)” 
表示 greater 函数 有 两 个 类 型 为 T 的 输入 参数 ， 该 函数 的 返回 值 是 Boolean 类 型 。 现 在 有 了 高 阶 函 
数 的 定义 ， 再 来 看 看 外 部 如 何 调用 这 个 高 阶 函 数 ， 调 用 的 示例 代码 如 下 : 


Var string array:Array<String>=arrayOf ("How", "do", "you", "do", "I'm 
"Fine") 
btn function higher.setOnClickListener { 
tv_function result.text = when (counts4) { 
//string_array.max() 返 回 的 是 you 
0 -> "字符 串 数组 的 默认 最 大 值 为 ${string array.max()}" 
// 因 为 高 阶 函 数 maxCustom 同时 也 是 泛 型 函数 ， 所 以 要 在 函数 名 称 后 面 加 上 <String> 
1 -> "字符 串 数组 按 长 度 比 较 的 最 大 值 为 S{maxCustom<String> (string_arrayv 
{ a, b -> a.length > b.length })}" 
//string_array.max () 对 应 的 高 阶 函 数 是 maxCustom(string_array，{f ar b -> 
a>b }) 
2 -> "字符 串 数组 的 默认 最 大 值 (使 用 高 阶 函数 ) 为 $ {maxCustom(string array, {a, 
b=->a>b i}" 
// 因 为 系统 可 以 根据 string_array 判断 泛 型 函数 采用 了 String 类 型 ， 故 而 函数 名 称 
后 面 的 <String> 也 可 以 省 略 掉 
else -> "字符 串 数组 按 去 掉 空 格 再 比较 长 度 的 最 大 值 为 StmaxCustom 
(string array, { a, b -> a.trim() .length > b.trim() .length })}" 
1 
Count++ 
} 


以 上 代码 在 调用 maxCustom 函数 时 ， 第 二 个 参数 被 大 括号 包 了 起 来 ， 这 是 Lambda 表达 式 的 
匿名 函数 写法 ， 中 间 的 “-> ”把 匿名 函数 分 为 两 部 分 ， 前 半 部 分 表示 函数 的 输入 参数 ， 后 半 部 分 表 
示 函 数 体 。“{ a,b -> alength> b.length } ”按照 规范 的 函数 写法 是 下 面 这 样 的 代码 : 

fun anonymous (a:String, b:String):Boolean { 

Var result:Boolean = a.length > b.length 


return result 


} 


最 后 演示 一 下 字符 串 数 组 获取 最 大 值 的 高 阶 函 数 调用 结果 ， 有 具体 如 图 4-17 一 图 4-20 所 示 。 其 
中 图 4-17 展示 字符 串 数 组 默认 的 max 方法 比较 结果 ， 此 时 最 大 值 为 “you”; 图 4-18 展示 依据 字 
符 串 长 度 的 比较 结果 ， 此 时 最 大 值 为 “Tm  ”; 图 4-19 展示 直接 使 用 大 于 号 比较 字符 串 的 结果 ， 
此 时 最 大 值 也 为 “you”， 可 见 该 方式 的 结果 就 跟 max 方法 一 样 ; 图 4-20 展示 先 将 字符 串 去 掉 末 
尾 空格 ， 再 比较 字符 串 长 度 的 结果 ， 此 时 最 大 值 为 “Fine”。 
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题目 : 脑筋 急 转 弯 题目 : 脑筋 急 转 弯 

答案 ”字符 串 数组 的 默认 最 大 值 为 you 答案 : i 
'm 

图 4-17 字符 串 数组 的 默认 比较 结果 图 4-18 ”高 阶 函数 按 长 度 的 比较 结果 


grammar grammar 


题目 : 脑筋 急 转 这 题目 : 脑筋 急 转 弯 
答案 : ”字符 串 数组 的 默认 最 大 值 (使 用 高 答案 : ”字符 串 数 组 按 去 掉 空格 再 比较 长 度 
的 最 大 值 为 Fi 


Ine 





阶 函 数 ) 为 You 


图 4-19 高 阶 函 数 按 默认 的 比较 结果 图 4-20 高 阶 函数 修整 子 串 再 比较 长 度 的 结果 


4.4 增强 系统 函数 


前 几 节 主要 介绍 了 Kotlin 函数 的 各 种 概念 ， 并 未 进行 真正 的 实战 演练 ， 假 如 把 Kotlin 函数 应 
用 于 实战 当中 ， 又 有 哪些 地 方 需要 加 以 注意 呢 ? 本 节 通 过 几 个 具体 的 实战 案例 进一步 六 述 Kotlin 
在 函数 增强 实战 中 的 具体 表现 。 


4.4.1 ”扩展 函数 


使 用 Java 开发 时 ， 虽 然 系统 自 带 的 类 已 经 提供 了 许多 方法 ， 然 而 经 常 还 是 无 法 完全 满足 业务 
需求 ， 此 时 开发 者 往往 要 写 一 个 工具 类 比如 字符 串 工具 类 StringUtil、 日 期 工具 类 DateUtil 等 ) 
来 补充 相关 的 处 理 功能 ， 长 此 以 往 ， 工 具 类 越 来 越 多 ， 也 越 来 越 难 以 管理 。 

基于 以 上 情况 ，Kotlin 推出 了 扩展 函数 的 概念 ， 扩 展 函 数 允许 开发 者 给 系统 类 补 写 新 的 方法 ， 
而 无 须 另外 编写 额外 的 工具 类 。 比 如 系统 自 带 的 数组 Array 提供 了 求 最 大 值 的 max 方法 ， 也 提供 
了 进行 排序 的 sort 方法 ， 可 是 并 未 提供 交换 数组 元 素 的 方法 。 于 是 我 们 打算 给 Array 数组 类 增加 新 
的 交换 方法 ， 也 就 是 添加 一 个 扩展 函数 swap。 与 普通 函数 定义 不 同 的 是 ， 要 在 swap 函数 名 称 前 面 
加 上 前 绥 “Array<Int>.”， 表 示 该 函数 扩展 自 系 统 类 Array<Int>。 下 面 是 用 于 交换 数组 元 素 的 swap 
函数 定义 代码 : 

fun Array<Int>.swap(posl: Int, pos2: Int) { 

val tmp = this[pos1] //this 表示 数组 自身 
this[pos1l] = this[pos2] 
this[pos2] = tmp 

有 

不 过 该 函数 的 缺点 是 显而易见 的 ,因为 它 声明 了 扩展 自 Array<Int>, 也 就 意味 着 只 能 用 于 整 型 
数组 ， 不 能 用 于 包括 浮 点 数组 、 双 精度 数组 在 内 的 其 他 数组 。 所 以 ， 为 了 增强 交换 函数 的 通用 性 ， 
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必须 把 swap 改写 为 泛 型 函数 ， 即 尖 括号 内 部 使 用 T 代替 Int。 将 swap 方法 改写 为 泛 型 函数 的 代码 
如 下 : 
// 扩 展 函数 结合 泛 型 函数 能 够 更 好 地 扩展 函数 功能 


fun <T> Array<T> .swap (posl: Int, pos2: Int) { 
val tmp = this[pos1l] //this 表示 数组 变量 自身 
this[Posl] = this[pos2] 
this[pos2] = tmp 
有 了 扩展 函数 之 后 , 数组 变量 可 以 直接 调用 新 增 的 swap 方法 , 仿佛 该 函数 是 系统 自 带 的 方法 ， 
用 起 来 毫 不 费劲 ， 真 是 开发 者 的 福音 。 以 下 是 swap 函数 调用 的 代码 例子 ， 每 调用 一 次 swap 方法 ， 
就 把 该 数组 的 第 一 个 元 素 和 第 四 个 元 素 进行 交换 : 
//val array:Rrray<Int> = arrayOf(1，2，3，4，5) 
val array:Array<Double> = arrayOf(1.0, 2.0, 3.0, 4.0, 5.0) 
btn function extend.setOnClickListener { 
// 下 标 为 0 和 3 的 两 个 数组 元 素 进行 交换 
//array 可 以 是 整 型 数组 ， 也 可 以 是 双 精 度数 组 
array.swap (0, 3) 
setArrayStr<Double> (array) 
} 


swap 函数 交换 数组 元 素 的 运行 效果 如 图 4-21 和 图 4-22 所 示 ， 其 中 图 4-21 所 示 为 交换 前 的 界 
面 截图 ， 图 4-22 所 为 交换 后 的 界面 截图 ， 可 以 看 到 第 一 个 元 素 “1.0” 与 第 四 个 元 素 “4.0” 被 交换 
了 过 来 。 


grammar grammar 


运算 结果 : ”数组 元 素 依次 排列 : 1.0, 2.0， 运算 结果 : 数组 元 素 依 次 排列 :4.0, 2.0， 
3.0, 4.0, 5.0, 3.0, 1.0, 5.0, 





图 4-21 数组 元 素 交换 前 的 界面 图 4.22 数组 元 素 交换 后 的 界面 


4.4.2 ”扩展 高 阶 函 数 


“4.3.5 高 阶 函数 ”小 节 中 提 到 的 maxCustom 同时 结合 了 高 阶 函 数 和 泛 型 函数 的 写法 , 其 实 还 
可 以 给 它 加 上 扩展 函数 的 功能 。 由 于 该 函数 的 目的 是 求 数 组 元 素 的 最 大 值 , 因此 不 妨 将 该 函数 扩展 
到 Array<T> 中 去 ， 扩 展 后 的 高 阶 函数 代码 示例 如 下 : 
fun <T> Array<T>.maxCustomize (greater: (T, T) -> Boolean): T? { 
var max: T? = null 
for (item in this) 
if (max == null || greater(item, max)) 
max = item 
return max 
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相对 应 地 , 新 的 maxCustomize 将 作为 数组 变量 的 方法 进行 调用 , 而 非 前 面 的 maxCustom 那样 
把 数组 变量 作为 入 参 。 下 面 是 改写 后 的 扩展 函数 调用 代码 : 
btn function higher.setOnClickListener { 
tv function result.text = when (count%4) { 
0 -> "字符 串 数组 的 默认 最 大 值 为 ${string array.max()}" 
// 下 面 是 结合 高 阶 函数 与 扩展 函数 的 调用 代码 
1 -> "字符 串 数组 按 长 度 比 较 的 最 大 值 为 ${string array.maxCustomize({ a, b 
-> a.length > b.length })}" 
2 -> "字符 串 数组 的 默认 最 大 值 (使 用 高 阶 函数 ) 为 
${string array.maxCustomize({ a, b->a>b 3})}" 
else -> "字符 串 数组 按 去 掉 空 格 再 比较 长 度 的 最 大 值 为 
${string array.maxCustomize({ a, b -> a.trim().length > b.trim() .length })}" 
} 


count++ 


4.4.3 日 期 时 间 函 数 


通过 前 面 两 个 小 节 的 介绍 , 使 用 扩展 函数 可 以 很 方便 地 扩充 数组 Array 的 功能 , 例如 交换 两 个 
数组 元 素 、 求 数组 的 最 大 元 素 等 。 那么 除了 数组 之 外 ,日 期 和 时 间 的 相关 操作 也 是 很 常见 的 ， 比 如 
获取 当前 日 期 、 获 取 当 前 时 间 、 获 取 指 定格 式 的 日 期 时 间 等 。 因 此 ， 基 本 上 每 个 采取 Java 编码 的 
Android 工程 都 需要 一 个 类 似 DateUtiljava 的 工具 类 ， 用 于 获得 不 同 格式 的 时 间 字 符 串 。 

下 面 的 Java 代码 便 是 一 个 实现 日 期 时 间 格 式 化 的 工具 类 例子 : 


public class DateUtil { 
// 获 取 当 前 完整 的 日 期 和 时 间 
Public static String getNowDateTime () { 
SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd HH:mm:ss"); 
return sdf.format (new Date()); 
上 


// 获 取 当 前 时 间 

Public static String getNowTime () { 
SimpleDateFormat sdf = new SimpleDateFormat ("HH:mm:ss"); 
return sdf.format (new Date()); 

} 


// 获 取 当 前 时 间 精确 到 毫秒 ) 

public static String getNowTimeDetail() { 
SimpleDateFormat sdf = new SimpleDateFormat ("HH:mm:ss.SSS"); 
return sdf.format (new Date()); 
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注意 到 上 述 代码 的 时 间 格 式 存在 大 小 写字 母 熔 合 的 情况 ， 为 了 避免 混淆 ， 有 必要 对 这 些 日 期 
时 间 格 式 的 定义 进行 补充 说 明 ， 有 具体 的 时 间 格 式 对 应 关系 见 表 4-1。 














表 4-1 日 期 时 间 格式 的 定义 说 明 
日 期 时 间 格 式 格式 说 明 
小 写 的 yyyy 表示 4 位 年 份 数字 ， 如 1949、2017 等 
大 写 的 MM 表示 两 位 月 份 数字 ， 如 01 表示 一 月 份 ，12 表示 12 月 份 
小 写 的 dd 表示 两 位 日 期 数字 ， 如 08 表示 当月 8 号 ，26 表示 当月 26 号 
大 写 的 HH 表示 24 小 时 制 的 两 位 小 时 数字 ， 如 19 表示 晚上 7 点 





表示 12 小 时 制 的 两 位 小 时 数字 ， 如 06 可 同时 表示 早上 6 点 与 傍晚 6 点 (因为 12 小 时 制 














Wa 的 表达 会 引发 歧义 ， 所 以 实际 开发 中 很 少 这 么 使 用 ) 
小 写 的 mm 表示 两 位 分 钟 数字 ， 如 30 表示 某 点 30 分 

小 写 的 ss 表示 两 位 秒 钟 数字 

大 写 的 SSS 表示 三 位 毫秒 数字 


时 间 格 式 内 部 其 余 的 横 线 “-”、 空 格 “”、 冒 号 “:”、 点 号 “.” 等 字符 仅仅 是 连接 符 ， 方 


便 观看 各 种 单位 的 时 间 数 字 而 已 ， 在 中 国 ， 





秒 ” 的 时 间 格 式 。 


也 可 采用 形 如 “yyyy 年 MM 月 dd 日 HH 时 mm 分 ss 


现在 利用 Kotlin 的 扩展 函数 就 无 须 书写 专门 的 DateUtil 工具 类 ， 直 接 写 几 个 系统 日 期 类 Date 
的 扩展 函数 即 可 实现 日 期 时 间 格 式 转换 的 功能 。 改 写 后 的 Date 类 扩展 函数 举例 如 下 : 
// 方 法 名 称 前 面 的 Date .表示 该 方法 扩展 自 Date 类 
// 返 回 的 日 期 时 间 格 式 形 如 2017-10-01 10:00:00 
fun Date.getNowDateTime () : String { 
val sdf = SimpleDateFormat ("yyyy-MM-dd HH:mm:ss") 


return sdf.format (this) 
1 


// 只 返回 日 期 字符 串 


fun Date.getNowDate(): String { 


val sdf = SimpleDateFormat ("yyyy-MM-dd") 


return sdf.format (this) 
} 


// 只 返回 时 间 字 符 串 


fun Date.getNowTime () : String { 


val sdf = SimpleDateFormat ("HH:mm:ss") 


return sdf.format (this) 
1 


// 返 回 详 细 的 时 间 字 符 串 ， 精 确 到 毫秒 





fun Date.getNowTimeDetail(): String { 
val sdf = SimpleDateFormat ("HH:mm:ss.SSS") 
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return sdf.format (this) 
} 


// 返 回 开发 者 指定 格式 的 日 期 时 间 字 符 串 

fun Date.getFormatTime (format: String=""): String { 
Var ft: String = format 
val sdf = if (!ft.isEmpty()) SimpleDateFormat (ft) 
else SimpleDateFormat ("yyyyMMddHHmmss") 
return sdf.format (this) 

} 


外 部 调用 这 些 日 期 类 的 扩展 函数 也 不 会 很 复杂 ， 以 下 代码 通过 “ Date().getNowDate()” 
“Date().getNowTime()” 等 方法 就 能 获取 相应 格式 的 日 期 和 时 间 字 符 串 : 


btn extend date.setOnClickListener { 
// 以 下 方法 调用 自 ExtendDate .kt， 采 取 了 扩展 函数 的 方式 
tv function result.text = "扩展 函数 : " + when (count++%5) { 
0 -> "当前 日 期 时 间 为 ${Date () .getNowDateTime () }" 
1 -> "当前 日 期 为 ${Date () .getNowDate () }" 
2 -> "当前 时 间 为 ${Date () .getNowTime ()}" 
3 -> "当前 毫秒 时 间 为 ${Date () .getNowTimeDetail ()}" 
else -> "当前 中 文 日 期 时 间 为 ${Date () .getFormatTime ("yyyy 年 MM 月 dd 日 HH 
时 mm 分 ss 秒 ")}" 
} 
和 


通过 扩展 函数 获取 日 期 时 间 的 效果 如 图 4-23 和 图 4-24 所 示 ， 其 中 图 4-23 展示 以 标点 分 隔 的 
日 期 时 间 字 符 串 ， 图 4-24 展示 以 中 文 分 隔 的 日 期 时 间 字 符 串 。 


grammar grammar 


扩展 函数 : 当前 日 期 时 间 为 运算 结果 : ”扩展 函数 ， 当 前 中 文 日 期 时 间 为 
2017-10-27 00:23:04 2017 年 10 月 27 日 00 时 23 分 22 秒 





图 4-23 ”以 标点 分 隔 的 日 期 时 间 图 4-24 以 中 文 分 隔 的 日 期 时 间 


4.4.4 ” 单 例 对 象 


虽然 扩展 函数 已 经 实现 日 期 信息 的 获取 ， 但 是 它 的 调用 方式 稍 显 烦 琐 ， 比 如 
“Date(.getNowDate0” 这 个 日 期 方法 一 共 占 了 4 个 括号 ， 容 易 使 人 产生 密集 恐惧 症 。 况 且 这 些 函 
数 必须 从 某 个 已 存在 的 类 扩展 而 来 , 倘若 没有 可 依赖 的 具体 类 , 也 就 无 法 书写 扩展 函数 。 所 以 , Java 
编码 常见 的 ***Util 工具 类 ， 某 种 程度 上 反而 更 灵活 、 适 应 面 更 广 ， 那 么 Kotlin 有 没有 专门 的 工具 
类 写法 呢 ? 

作为 一 个 后 起 之 秀 , Kotlin 的 设计 者 显然 考虑 到 了 这 种 情况 , 并 且 给 出 了 有 针对 性 的 解决 方案 。 
在 Java 中 ， 无论 是 工具 类 还 是 实体 类 抑或 是 业务 类 ， 统 统 采用 class 关键 字 ， 如 果 是 工具 类 ， 其 内 
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部 的 方法 都 加 上 static 修饰 符 ， 表 示 这 种 方法 是 静态 方法 ， 无 须 对 类 进行 构造 操作 即 可 调用 。 如 此 
这 般 ， 搞 得 Java 的 class 像 个 万 金 油 ， 什 么 都 能 做 ， 却 什么 都 要 特殊 处 理 。 鉴 于 此 ，Kotlin 将 工具 
类 的 用 法 提炼 了 出 来 ,既然 这 个 东西 仅仅 是 作为 工具 ,那么 一 旦 制定 了 规格 就 不 会 再 改变 了 , 不 能 
构造 也 不 能 修改 。 故 而 Kotlin 使 用 对 象 关键 字 object 加 以 修饰 ， 并 称 之 为 “ 单 例 对 象 ”， 其 实 就 相 
当 于 Java 的 工具 类 。 

单 例 对 象 的 用 法 跟 传 统 的 类 比较 ， 像 是 一 种 痢 制 了 的 简化 类 ， 倘 若 把 普通 类 比 做 App， 则 单 
例 对 象 好 比 小 程序 ， 用 完 即 走 ， 不 留 下 一 抹 痕 迹 。 辟 如 前 面 提 到 的 getNowDateTime 方法 ， 在 单 例 
对 象 中 会 分 解 成 两 个 部 分 ， 第 一 个 部 分 是 字符 串 nowDateTime 的 变量 声明 ， 第 二 个 部 分 是 紧 跟着 
的 获取 变量 值 的 get 方法。 外 部 访问 单 例 对 象 的 内 部 变量 时 ， 系 统 会 自动 调用 该 变量 的 get 方法 。 

下 面 是 采取 单 例 对 象 改写 后 的 日 期 时 间 工 具 代 码 : 

// 关 键 字 object 用 来 声明 单 例 对 象 ， 就 像 Java 中 开发 者 自己 定义 的 Utils 工具 类 


// 其 内 部 的 属性 等 同 于 Java 中 的 static 静态 属性 ， 外 部 可 直接 获取 属性 值 
object DateUtil { 





// 声 明 一 个 当前 日 期 时 间 的 属性 
// 返 回 的 日 期 时 间 格 式 形 如 2017-10-01 10:00:00 
val nowDateTime: String 


// 外 部 访问 DateUtil.nowDateTime 时 , 会 自动 调用 nowDateTime 附属 的 get 方法 得 到 


get() { 
val sdf = SimpleDateFormat ("yyyy-MM-dd HH:mm:ss") 
return sdf.format (Date()) 

} 


// 只 返回 日 期 字符 串 
val nowDate: String 
get() { 
val sdf = SimpleDateFormat ("yyyy-MM-dd") 
return sdf.format (Date()) 
} 


// 只 返回 时 间 字 符 串 
val nowTime: String 
get() { 
val sdf = SimpleDateFormat ("HH:mm:ss") 
return sdf.format (Date()) 
} 


// 返 回 详 细 的 时 间 字 符 串 ， 精 确 到 毫秒 
val nowTimeDetail: String 
get() { 
val sdf = SimpleDateFormat ("HH:mm:ss.SSS") 
return sdf.format (Date()) 
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// 返 回 开发 者 指定 格式 的 日 期 时 间 字符 串 
fun getFormatTime (format: String=""): String { 
val ft: String = format 
val sdf = if (!ft.isEmpty()) SimpleDateFormat (ft) 
else SimpleDateFormat ("yyyyMMddHHmmss") 
return sdf.format (Date()) 


} 


外 部 车 要 访问 单 例 对 象 的 变量 值 ， 直 接 调用 “对 象 名 称 .变量 名 称 ” 即 可 ， 此 时 晃 冉 眼 的 括号 
都 不 见 踪影 ， 一 下 子 干净 了 许多 。 调 用 单 例 对 象 的 代码 例子 如 下 所 示 ， 看 起 来 变 得 更 加 简洁 了 : 
btn object date.setOnClickListener { 
// 以 下 方法 调用 自 pateUtil .kt， 采 取 单 例 对 象 的 方式 
tv_function result.text = " 单 例 对 象 : " + when (count++%5) { 
0 -> "当前 日 期 时 间 为 ${DateUtil.nowDateTime}" 
1 -> "当前 日 期 为 ${DateUtil .nowDate}" 
2 -> "当前 时 间 为 ${DateUtil.nowTime}" 
3 -> "当前 毫秒 时 间 为 ${DateUtil .nowTimeDetail}" 
else -> "当前 中 文 日 期 时 间 为 ${DateUtil.getFormatTime ("yyyy 年 MM 月 dd 日 
HH 时 mm 分 ss 秒 ")}" 
} 
} 


4.5 小 2 


本 章 介绍 了 Kotlin 对 函数 的 几 个 常见 运用 方式 ， 包 括 如 何 定 义 一 个 简单 的 函数 、 如 何 灵活 地 
使 用 函数 的 输入 参数 、 几 种 特殊 函数 的 概念 及 其 用 法 、 如 何 利 用 Kotlin 特性 对 系统 函数 进行 增 
强 等 。 

通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 技能 : 

(1) 学 会 定义 一 个 包括 输入 参数 和 输出 参数 在 内 的 完整 函数 形态 。 

(2) 学 会 输入 参数 的 几 种 特殊 定义 ， 包 括 默认 参数 、 命 名 参数 、 可 变 参 数 ， 以 及 如 何在 外 部 
传送 这 些 特殊 的 输入 参数 。 

(3) 学 会 常见 的 几 种 特殊 函数 的 定义 与 使 用 ， 包 括 泛 型 函数 、 单 例 函 数 、 简 化 函数 、 尾 递归 
函数 、 高 阶 函 数 等 。 

(4) 学 会 合理 利用 扩展 函数 、 单 例 对 象 等 新 特性 对 系统 函数 进行 功能 增强 。 


类 和 对 象 


第 4 童 末尾 提 到 单 例 对 象 可 用 于 实现 形态 简单 的 工具 类 ， 那 么 形态 各 异 、 血 肉 丰 满 的 普通 类 
又 是 怎么 实现 的 呢 ? 为 解答 这 个 疑问 ， 本 章 将 好 好 描述 一 下 Kotlin 对 类 和 对 象 的 具体 用 法 ， 并 分 
别 从 构造 、 成 员 、 继 承 、 特 殊 类 等 几 个 维度 进行 详细 的 分 析 和 介绍 。 


5.1 类 的 构造 


正 所 谓 高 楼 大 厦 平 地 起 ， 无 论 是 简单 的 类 ， 还 是 极其 复杂 的 类 ， 一 开头 都 是 从 零 开 始 的， 再 
由 简单 到 复杂 、 由 基础 到 高 级 。 对 于 类 来 说 ， 一 开始 只 做 一 件 事 : 弄 块 场地 搞 个 开工 仪式 ， 表示 这 
事 就 这 么 定 了 ， 接 下 来 要 返 起 袖子 开 干 了 。 类 的 开工 仪式 即 为 “ 挨 踢 民工 ”熟知 的 构造 函数 ， 接 下 
来 就 阐述 类 里 面 构造 函数 的 具体 用 法 。 


5.1.1 类 的 简单 定义 


先 来 看 看 在 Android 开发 中 多 次 见 过 的 类 MainActivity， 在 Java 代码 中 该 类 的 写法 如 下 所 示 : 
Public class MainActivity extends AppCompatActivity { 


. // 此 处 省 略 类 的 内 部 代码 
} 


而 对 应 的 Kotlin 代码 是 下 面 这 样 的 : 


class MainActivity : AppCompatActivity() { 
// 此 处 省 略 类 的 内 部 代码 
1 


根据 上 述 代码 简单 地 比较 ，Kotlin 对 类 的 写法 与 Java 之 间 有 以 下 几 点 区 别 : 
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(1) Kotlin 省 略 了 关键 字 public， 缘 于 它 默认 就 是 开放 的 。 
(2) Kotlin 用 冒号 “:” 代 替 extends， 也 就 是 通过 冒号 表示 继承 关系 。 
(3) Kotlin 进行 继承 时 ， 父 类 后 面 多 了 括号 “0”。 
表面 上 二 者 区 别 不 大 ， 其 实 类 这 部 分 大 有 玄机 ， 真 正 用 Kotlin 实现 让 人 出 乎 意料 ， 接 下 来 要 
层 层 剖析 ， 逐 步 认识 Kotlin 类 的 真面目 。 从 简单 的 类 定义 开始 ， 下 面 是 名 为 Animal 的 动物 类 定义 
的 代码 : 
class Animal { 
// 类 的 初始 化 函数 
nat f 
//Kotlin 使 用 println 替换 Java 的 System.out.println 
println ("Animal: 这 是 个 动物 的 类 ") 





} 
对 应 在 外 部 为 Animal 类 创建 实例 的 代码 如 下 所 示 : 


btn_class_simple.setOnClickListener { 
//var animal: Rnimal = Rnimal() 
// 因 为 根据 等 号 后 面 的 构造 函数 已 经 明确 知道 这 是 个 Animal 的 实例 
// 所 以 声明 对 象 时 可 以 不 用 指定 它 的 类 型 
Var animal = Rnimal() 
tv_class init.text = "简单 类 的 初始 化 结果 见 日 志 " 
上 


然后 继续 给 Kotlin 找茬 ， 不 费 多 少 工夫 又 发 现 了 它 跟 Java 的 三 点 不 同 之 处 : 
(1) Kotlin 对 类 进行 初始 化 的 函数 名 称 叫 init， 不 像 Java 那样 把 类 名 作为 构造 函数 的 名 称 。 
(2) Kotlin 打印 日 志 使 用 类 似 C 语言 的 printIn 方法 ， 而 非 Java 的 System.outprintln 。 
(3) Kotlin 在 创建 实例 时 省 略 了 关键 字 new。 
其 中 , 初始 化 函数 init 看 似 是 Kotlin 对 类 的 构造 函数 ,但 它 只 是 构造 函数 的 一 部 分 ， 并 非 完 整 
的 构造 函数 。init 方 法 只 定义 了 初始 化 操作 ， 却 无 法 直接 定义 输入 参数 ， 因 为 管理 入 参 定义 的 男 有 
其 人 。 


5.1.2 ”类 的 构造 函数 


第 4 章 介绍 函数 的 时 候 ， 提 到 Kotlin 把 函数 看 成 是 一 种 特殊 的 变量 ， 那 么 类 在 某 种 意义 上 算 
是 一 种 特殊 的 函数 。 所 以 构造 函数 的 输入 参数 得 直接 加 到 类 名 后 面 ， 而 init 方法 仅仅 表示 创建 类 实 
例 时 的 初始 化 动作 。 下 面 是 添加 了 入 参 的 类 定义 代码 : 
// 如 果 主 构造 函数 没有 带 8 符 号 的 注解 说 明 ， 类 名 后 面 的 constructor 就 可 以 省 略 
//class AnimalMain (context:Context, name:String) { 
class AnimalMain constructor(context:Context, name:String) { 
jinit { 
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context .toast ("这 是 内 $name") 


1 
然而 以 上 代码 似乎 存在 问题 ， 因 为 一 个 类 可 能 会 有 多 个 构造 函数 ， 像 自 定义 视图 常常 需要 定 
义 三 个 构造 函数 ， 例 如 下 面 是 某 个 自 定义 视图 的 Java 代码 : 
Public class CustomView extends View { 
Public CustomView (Context context) { 


super (context); 


; 


public CustomView (Context context,AttributeSet attrs) { 
super (context, attrs); 


} 


Public CustomView (Context context, AttributeSet attrs, int defStyleAttr) { 
super (context, attrs, defStyleAttr); 
} 

} 

对 于 上 述 这 种 存在 多 个 构造 函数 的 情况 ，Java 可 以 通过 覆 写 带 不 同 参数 的 构造 函数 来 实现 ， 
那么 Kotlin 已 经 在 类 名 后 面 指明 了 固定 数量 的 入 参 ， 又 该 如 何 表示 拥有 其 他 参数 的 构造 函数 ? 针 
对 这 个 疑点 ，Kotlin 引入 了 主 构造 函数 与 二 级 构造 函数 的 概念 。 之 前 代码 演示 的 只 是 主 构造 函数 ， 
分 为 两 部 分 : 跟 在 类 名 后 面 的 参数 是 主 构造 函数 的 入 参 ， 同 时 init 方法 是 主 构造 函数 的 内 部 代码 。 
至 于 二 级 构造 函数 ， 则 可 以 在 类 内 部 直接 书写 完整 的 函数 表达 式 。 

为 了 让 读者 有 更 直观 的 认识 ， 下 面 先 贴 出 一 段 包 含 二 级 构造 函数 的 Kotlin 类 定义 代码 : 

class AnimalMain constructor(context:Context, name:String) { 

mit 革 
context .toast (" 这 是 只 Sname") 
. 


constructor (context:Context, name:String, sex:Int) : this(context, name) { 
var sexName:String = if(sex==0) " 公 " else " 母 " 
context.toast ("这 只 ${name} 是 ${sexName} 的 ") 


' 

从 以 上 代码 可 以 看 出 ， 二 级 构造 函数 和 普通 函数 相 比 有 两 个 区 别 : 

(1) 二 级 构造 函数 没有 函数 名 称 ， 只 用 关键 字 constructor 表示 这 是 一 个 构造 函数 。 

(2) 二 级 构造 函数 需要 调用 主 构造 函数 。“this(context，name) ”这 句 代 码 在 Java 中 要 以 
“super(context, name)” 的 形式 写 在 函数 体内 部 ， 在 Kotlin 中 则 以 冒号 开头 补充 到 输入 参数 后 面 ， 
这 意味 着 二 级 构造 函数 实际 上 是 从 主 构造 函数 派生 而 来 的 ,也 可 看 作 二 级 构造 函数 的 返回 值 是 主 构 
造 函 数 。 
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由 此 看 来 ， 二 级 构造 函数 从 属于 主 构造 函数 ， 如 果 使 用 二 级 构造 函数 声明 该 类 的 实例 ， 系 统 
就 会 先 调 用 主 构造 函数 的 init 代码 ， 再 调用 二 级 构造 函数 的 自身 代码 。 现 在 若 想 声 明 AnimalMain 
类 的 实例 ， 既 可 通过 主 构造 函数 声明 ， 也 可 通过 二 级 构造 函数 声明 ， 有 具体 的 声明 代码 如 下 所 示 : 

btn_class_main.setOnClickListener { 
setAnimalInfo() 
when (count%2) { 
0 -> { var animal = AnimalMain (this, animalName) } 
else -> { var animal = AnimalMain (this, animalName, animalSex) } 


, 
不 过 在 测试 过 程 中 发 现 ， 通 过 二 级 构造 函数 声明 实例 有 一 个 问题 ， 就 是 toast 会 弹 窗 两 次 。 原 
因 是 主 构造 函数 的 init 方法 已 经 弹 窗 ， 然 后 二 级 构造 函数 自身 再 次 弹 窗 ， 看 来 这 么 做 并 不 完美 ， 能 
否 不 要 强制 调用 主 构造 函数 呢 ? 为 了 解决 该 问题 , Kotlin 设 定 了 主 构造 函数 不 是 必需 的 , 也 就 是 说 ， 
类 可 以 把 几 个 构造 函数 都 放 在 类 内 部 定义 ， 从 而 都 变 成 二 级 构造 函数 ， 如 此 就 去 掉 了 主 构造 函数 。 
据 此 修改 之 后 的 类 定义 代码 如 下 所 示 : 


class AnimalSeparate { 





constructor (context:Context, name:String) { 
context .toast ("这 是 只 $name") 
. 


constructor (context: Context, name:String, sex:Int) { 
var sexName:String = if(sex==0) " 公 " else " 母 " 
context .toast ("这 只 ${name} 是 ${sexName} 的 ") 


} 


这 样 一 来 ， 新 类 AnimalSeparate 便 不 存在 主 构造 函数 了 ， 两 个 二 级 构造 函数 之 间 没 有 从 属 关 
系 , 它们 各 自 的 函数 代码 是 互相 独立 的 。 无 论 通 过 哪个 构造 函数 声明 类 的 实例 ,都 只 会 调用 这 个 构 
造 函 数 的 代码 ， 而 不 会 像 之 前 那样 去 调用 主 构造 函数 的 代码 了 。 


5.1.3 ” 带 默认 参数 的 构造 函数 


未 料 如 此 折腾 一 香 ， 隐 隐 感 觉 哪里 不 对 劲 ， 独 然 发 现 改 来 改 去 ，AnimalSeparate 类 依旧 完整 写 
着 两 个 构造 函数 ， 这 么 做 跟 Java 的 构造 函数 写法 又 有 什么 区 别 呢 ? 无 非 是 把 类 名 换 成 了 关键 字 
constructor， 其 他 地 方 仍然 换 汤 不 换 药 。Kotlin 的 宗旨 是 化 繁 为 简 ， 没 想到 结果 却 返 瑛 归真 了 ， 真 
是 令 人 吓 出 一 身 冷汗 。 喘 急 莫 急 ， 倘 若 Kotlin 黑 驴 技 穷 ， 那 么 它 根 本 没 资格 挑战 Java， 所 以 肯定 
是 有 办 法 的 。 读 者 是 否 还 记得 第 4 章 介绍 函数 时 说 到 的 默认 参数 ? 类 的 构造 函数 同样 也 能 添加 默认 
参数 。 

注意 到 AnimalSeparate 类 的 两 个 构造 函数 只 是 相差 一 个 输入 参数 ， 所 以 完全 可 以 把 它们 合并 
成 一 个 带 默 认 参 数 的 主 构造 函数 ,新 的 主 构造 函数 既 能 输入 两 个 参数 ， 又 能 输入 三 个 参数 。 如 果 利 
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用 带 两 个 入 参 的 主 构造 函数 创建 实例 ， 就 形 同 调用 了 原来 的 第 一 个 构造 函数 “constructor(context: 
Context, name:String)”; 如 果 利 用 带 三 个 入 参 的 主 构 造 函 数 创建 实例 ， 就 形 同 调用 了 原来 的 第 二 个 
构造 函数 “constructor(context: Context, name:String, sex:Int)”。 

下 面 为 主 构造 函数 采取 默认 参数 的 类 定义 代码 : 

// 类 的 主 构造 函数 使 用 了 默认 参数 


class AnimalDefault (context: Context, name:String, sex:Int = 0) { 





dinat 
var sexName:String = if(sex==0) " 公 " else " 母 " 
context .toast ("这 只 $ {name} 是 ${sexName} 的 ") 


} 


这 下 看 起 来 简洁 了 许多 ， 新 类 AnimalDefault 用 起 来 也 毫 不 费事 ， 之 前 的 实例 创建 代码 只 要 换 
个 类 名 就 好 ， 完 全 无 缝 对接。 具体 的 外 部 调用 代码 如 下 所 示 : 
btn class default.setOnClickListener { 
setAnimalInfo() 
when (count%2) { 
0 -> { var animal = AnimalDefault (this, animalName) } 
else -> { var animal = AnimalDefault (this, animalName, animalSex) } 


; 


构造 函数 使 用 默认 参数 ， 在 Kotlin 代码 中 完全 运行 正常 ， 然 而 一 个 项 目 往往 是 多 人 协作 开发 ， 
“ 码 农 ” 甲 写 了 一 个 Kotlin 的 类 AnimalDefault，“ 码 农 ” 乙 没 学 过 Kotlin 仍旧 用 Java 声明 该 类 的 
实例 ， 声 明 该 类 实例 的 Java 代码 如 下 所 示 : 


AnimalDefault animal = new AnimalDefault (this, animalName); 


原本 司空 见 惯 的 代码 , 未 曾 想 编译 器 居然 报错 , 说 什么 参数 不 匹配 , 这 可 傻眼 了 , 为 什么 Kotlin 
用 得 好 好 的 默认 参数 ， 到 Java 那 边 就 不 行 了 呢 ? 这 是 因为 Java 并 不 会 直接 支持 默认 参数 ， 若 想 让 
Java 也 能 识别 构造 函数 的 默认 参数 ， 得 往 该 类 的 构造 函数 添加 注解 “@JvmOverloads”， 告 知 编译 
器 这 个 类 是 给 Java 重 载 用 的 ， 好 比 配备 了 一 个 同 声 翻译 机 ， 既 能 听 得 懂 Kotlin 代码 ， 又 能 听 得 懂 
Java 代码 。 

下 面 是 添加 了 注解 说 明 的 AnimalDefault 类 代码 : 

// 加 上 evmoverloads 的 目的 是 让 Java 代码 也 能 识别 默认 参数 

// 因 为 添加 了 注解 标记 ， 所 以 必须 补 上 关键 字 constructor 

class AnimalDefault @JvmOverloads constructor (Context : Context, name:String, 
sex:Int = 0) { 

Tone 





var sexName:String = if(sex==0) " 公 " else " 母 " 
context .toast ("这 只 ${name} 是 ${sexName} 的 ") 
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改写 后 的 AnimalDefault 类 通过 注解 增加 了 Java 的 接 入 支持 ， 现 在 Java 代码 也 能 够 像 Kotlin 
那样 声明 该 类 的 实例 了 。 具 体 的 Java 声明 代码 如 下 所 示 : 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.btn class seperate) { 


setAnimalInfo(); 
if (countgs2 == 0) { 
//Java 代码 不 允许 直接 支持 默认 参数 
// 若 想 让 Java 代码 识别 默认 参数 ， 则 需 给 该 类 的 构造 函数 添加 注解 6eJvmoverloads 
AnimalDefault animal = new AnimalDefault (this, animalName); 
} else { 
//Java 代码 必须 调用 参数 完整 的 构造 函数 
AnimalDefault animal = new AnimalDefault (this, animalName, 
animalSex); 


上 
总 结 一 下 ，Kotlin 给 类 的 构造 函数 引进 了 关键 字 constructor， 并 且 区 分 了 主 构造 函数 和 二 级 构 
造 函 数 。 主 构造 函数 的 入 参 在 类 名 后 面 声明 ,函数 体 则 位 于 init 方法 中 ; 二 级 构造 函数 从 属于 主 构 
造 函 数 ， 它 不 但 由 主 构造 函数 派生 而 来 ， 而 且 必定 先 调用 主 构造 函数 的 实现 代码 。 另 外 ，Kotlin 的 
构造 函数 也 支持 默认 参数 ， 从 而 避免 了 元 余 的 构造 函数 定义 。 





5.2 ”类 的 成 员 


5.1 节 介绍 了 类 的 简单 定义 及 其 构造 方式 ， 当 时 为 了 方便 观察 演示 结果 ， 在 示例 代码 的 构造 函 
数 中 直接 调用 toast 提示 方法 ， 但 实际 开发 是 不 能 这 么 干 的 。 合 理 的 做 法 是 外 部 访问 类 的 成 员 属 性 
或 者 成 员 方法 ， 从 而 获得 处 理 之 后 的 返回 值 ,然后 外 部 再 根据 返回 信息 判断 对 应 的 处 理 方式 。 鉴 于 
此 ， 本 节 就 来 谈 谈 Kotlin 如 何 声明 成 员 属性 和 成 员 方法 ， 以 及 外 部 如 何 访问 类 的 成 员 。 





5.2.1 成 员 属 性 


接 上 一 节 动 物 类 的 例子 ， 每 只 动物 都 有 名 称 和 性 别 两 个 属性 ， 所 以 必然 要 在 构造 函数 中 输入 
这 两 个 参数 ， 对 应 的 类 代码 如 下 所 示 : 

class WildAnimal (name:String, sex:Int = 0) { 

} 


这 下 有 了 输入 参数 ， 还 得 声明 对 应 的 属性 字段 ， 用 来 保存 入 参 的 数值 。 假 如 按照 Java 的 编码 
思路 ，Kotlin 给 WildAnimal 类 添加 两 个 属性 后 的 代码 应 该 是 下 面 这 样 的 
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class WildAnimal (name:String, sex:Int = 0) { 
var name:String //var 表示 动物 名 称 可 以 修改 
val sex:Int //val 表示 动物 性 别 不 可 修改 
dnlt § 
this.name = name 


this.sex = sex 


1 


要 是 用 惯 了 Java 语言 ， 可 能 觉得 上 面 的 写法 理所当然 ， 没 有 什么 地 方 不 妥 。 但 你 是 否 想 过 ， 
以 上 代码 至 少 有 两 个 元 余 之 处 ? 


(1) 属性 字段 跟 构 造 函数 的 入 参 ， 二 者 不 但 名 称 一 样 ， 并 且 变 量 类 型 也 是 一 样 的 。 
(2) 初始 化 函数 中 给 属性 字段 赋值 ， 为 了 区 别 同 名 的 属性 与 入 参 ， 特 意 给 属性 字段 添加 了 前 
缀 “this.”。 


你 一 拍 脑袋 ， 吐 咕 道 : “说 的 也 是 ”。 喝 唆 是 喝 唆 了 一 些 ， 可 大 家 都 这 么 写 ， 难 不 成 Kotlin 
还 有 更 短 的 写法 ? 正 所 谓 细微 处 见 差 别 , 这 种 看 似 平常 的 代码 , 无 意 中 给 程序 员 带 来 了 不 少 重复 劳 
动 。 其 实 此 处 的 代码 逻辑 很 简单 ， 仅 仅 是 把 构造 函数 的 输入 参数 保存 到 类 的 属性 中 ,无 论 输入 参数 
有 几 个 ， 该 类 都 依 样 画 闷 地 声明 同样 数量 的 属性 字段 并 加 以 赋值 。 

既然 属性 字段 和 构造 函数 的 入 参 存在 一 一 对 应 关系 ， 那 么 可 以 通过 某 种 机 制 让 编译 器 自动 对 
其 命名 与 赋值 。Kotlin 正 是 遵循 了 类 似 的 设计 思路 ， 且 看 下 面 的 Kotlin 代码 是 怎样 实现 的 : 

class WildAnimal (var name:String, val sex:Int = 0) { 

) 


看 到 Kotlin 的 属性 声明 代码 ， 会 不 会 觉得 很 不 可 思议 ? 与 本 节 开头 的 类 代码 相 比 ， 只 有 两 个 
改动 之 处 : 其 一 是 给 名 称 参数 前 面 增加 了 关键 字 “var”， 表 示 同 时 声明 与 该 参数 同名 的 可 变 属性 
并 自动 赋值 ， 其 二 是 给 性 别 参数 前 面 增加 了 关键 字 “val”， 表 示 同 时 声明 与 该 参数 同名 的 不 可 变 
属性 并 自动 赋值 。 而 改动 后 的 代码 的 运行 结果 和 手工 添加 属性 声明 并 赋值 的 代码 是 一 样 的 。 

比如 下 面 的 演示 代码 ， 只 要 声明 WildAnimal 类 的 对 象 实例 ， 即 可 直接 访问 该 对 象 的 名 称 和 性 
别 字段 : 

btn member default.setOonClickListener { 
setAnimalInfo() 
Var animal = when (count%2) { 
0 -> WildAnimal (animalName) 
else -> WildAnimal (animalName, animalSex) 
} 
tv_class member.text = "这 只 ${animal .name} 是 ${if (animal.sex==0) " 公 " 
else " 母 "} 的 " 
下 

倘若 WildAnimal 类 使 用 Java 编码 实现 ， 按 常规 还 得 补充 形 如 “get***” 的 属性 获取 方法 ， 以 

及 形 如 “set***” 的 属性 设置 方法 ， 对 应 的 完整 Java 实现 代码 如 下 所 示 : 


Public class Wildanimal { 


Private String name; 


Private int sex; 


Public WildAnimal (String name, int sex) { 
this .name = namme; 
this.sex = sex; 


| 


public String getName() { 
return this.name; 


Public void setName (String name) { 
this .name = name; 


Public int getSex() { 
return this.sex; 


1 


Public void setSex (int sex) { 
this.sex = sex; 


E 


不 比 不 知道 ， 比 一 比 才 发 现 原来 Kotlin 大 幅 精 简 了 代码 ， 包 括 : 

(1) 宛 余 的 同名 属性 声明 语句 。 

(2) 宛 余 的 同名 属性 赋值 语句 。 

(3) 宛 余 的 属性 获取 方法 与 设置 方法 。 

看 到 这 里 ， 还 有 什么 理由 不 好 好 学 习 Kotlin 呢 ? 它 既 为 程序 员 
效 增强 了 代码 的 可 读 性 。 

如 果 某 个 字段 并 非 入 参 的 同名 属性 ， 就 需 在 类 内 部 显 式 声明 该 属性 字段 。 例 如 ， 前 面 
WildAnimal 类 的 性 别 只 是 一 个 整 型 的 类 型 字段 ， 而 界面 上 展示 的 是 性 别 的 中 文 名 称 ， 所 以 应 当 给 
该 类 补充 一 个 性 别名 称 的 属性 字段 sexName， 这 样 每 次 访问 sexName 字段 即 可 获得 动物 的 性 别名 
称 。 下 面 是 补充 了 新 属性 之 后 的 类 定义 代码 : 


class WildAnimalMember (var name:String, val sex:Int = 0) { 


// 非 空 的 成 员 属性 必须 在 声明 时 赋值 或 者 在 构造 函数 中 赋值 
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// 否 则 编译 器 会 报错 “Property must be initialized or be abstract” 


Var sexName:String 
站 

sexName = if(sex==0) " 公 " else " 母 " 
} 


减少 了 大 量 的 重复 劳动 ， 还 有 
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现在 外 部 的 调用 代码 可 以 直接 访问 新 增 字 段 sexName 了 ， 对 应 的 外 部 调用 代码 如 下 所 示 : 
btn member custom.setOnClickListener { 
setAnimalInfo() 
Var animal = when (count$%2) { 
0 -> WildAnimalMember (animalName) 
else -> WildAnimalMember (animalName, animalSex) 
nh 


tv_class member.text = "这 只 ${animal.name} 是 ${animal .sexName} 的 " 


} 
5.2.2 ”成员 方法 


类 的 成 员 除 了 成 员 属性 还 有 成 员 方法 ， 在 类 内 部 定义 成 员 方法 的 过 程 类 似 于 第 4 章 提 到 的 普 
通 函 数 定义 ， 具 体 参见 “4.1 函数 的 基本 用 法 ”和 “4.2 输入 参数 的 变化 ”， 这 里 不 再 袭 述 。 下 面 
给 出 在 动物 类 中 定义 成 员 方法 的 代码 例子 ， 主 要 增加 一 个 获取 动物 描述 信息 的 成 员 方法 getDesc: 

class WildAnimalFunction (var name:String, val sex:Int = 0) { 

var sexName:String 
年间 汪汪 
sexName = if(sex==0) " 公 " else " 母 " 


fun getDesc (tag:String) :String { 
return "欢迎 来 到 $tag: 这 只 ${name} 是 ${sexName} 的 。" 
i: 
} 


至 于 外 部 调用 成 员 方法 的 过 程 ， 一 样 是 先 声明 该 类 的 实例 ， 然 后 通过 “实例 名 称 . 方 法 名 称 ( 输 
入 参数 )” 的 格式 进行 函数 调用 ， 这 种 形式 跟 Java 相 比 没什么 区 别 。 以 上 面 的 WildAnimalFunction 
类 为 例 ， 外 部 调用 成 员 方法 getDese 的 具体 代码 如 下 所 示 : 
btn member function.setOnClickListener { 
setAnimalInfo() 
Var animal = when (count%2) { 
0 -> WildaAnimalFunction (animalName) 
else -> WildAnimalFunction(animalName, animalSex) 
} 
tv_class member.text = animal.getDesc ("动物 园 ") 
上 





改 为 通过 成 员 方 法 获得 加 工 后 的 返回 信息 ，Activity 代码 就 无 须 自行 拼接 动物 信息 字符 串 了 ， 
直接 把 成 员 方法 的 返回 值 拿 来 使 用 即 可 。 上 述 调用 成 员 方 法 的 演示 效果 如 图 5-1 和 图 5-2 所 示 ， 其 
中 图 5-1 展示 只 有 一 个 构造 入 参 的 动物 描述 信息 ， 图 5-2 展示 有 两 个 构造 入 参 的 动物 描述 信息 。 
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grammar grammar 


Cs 人 这 只 老虎 是 公 Es Re 这 只 斑马 是 母 





图 5-1 只 有 一 个 构造 入 参 的 动物 信息 图 5-2 有 两 个 构造 入 参 的 动物 信息 


5.2.3 ”伴生 对 象 


前 面 介绍 了 Kotlin 对 成 员 属性 和 成 员 方法 的 处 理 方式 ， 外 部 无 论 是 访问 成 员 属 性 还 是 访问 成 
员 方 法 ， 都 得 先 声明 类 的 对 象 ， 再 通过 对 象 访问 类 的 成 员 。 可 是 Java 还 有 静态 成 员 的 概念 ， 静 态 
成 员 使 用 关键 字 static 来 修饰 ， 且 外 部 是 通过 “类 名 .静态 成 员 名 称 ” 的 形式 访问 静态 成 员 〈 包 括 静 
态 属性 和 静态 方法 ) 的 。 
然而 Kotlin 取消 了 关键 字 static， 也 就 无 法 直接 声明 静态 成 员 。 为 了 弥补 这 方面 的 功能 缺陷 ， 
Kotlin 引入 了 伴生 对 象 的 概念 ， 可 以 把 它 理解 为 “影子 ”， 伴 生 对 象 之 于 它 所 在 的 类 仿佛 是 如 影 随 
形 。 打 个 比方 ， 类 的 实例 犹如 这 个 类 的 孩子 ， 一 个 类 可 以 拥有 很 多 个 孩子 ， 而 影子 只 有 一 个 ， 并 且 
孩子 需要 繁衍 而 来 , 但 影子 天 生 就 有 、 无 须 繁衍 。 利 用 伴生 对 象 的 技术 可 间接 实现 静态 成 员 的 功能 ， 
在 “5.2.1 成 员 属性 ”小 节 有 一 个 从 性 别 类 型 获得 性 别名 称 的 例子 ， 反 过 来 也 可 以 从 性 别名 称 获得 
性 别 类 型 ， 要 想 实现 该 功能 ， 可 在 伴生 对 象 中 定义 一 个 静态 方法 judgeSex 来 判断 性 别 类 型 。 
下 面 给 出 使 用 伴生 对 象 扩充 类 定义 的 代码 例子 : 
class WildAnimalCompanion (var name:String, val sex:Int = 0) { 
var sexName:String 
SEE 
sexName = if(sex==0) " 公 " else " 母 " 
下 


fun getDesc (tag:String) :String { 
return "欢迎 来 到 Stag: 这 只 $ {name} 是 ${sexName} 的 。" 
} 


// 在 类 加 载 时 就 运行 伴生 对 象 的 代码 块 ， 其 作用 相当 于 Java 里 面 的 static { ... } 代 码 块 
// 关 键 字 companion 表示 伴随 ，object 表示 对 象 ，WildAnimal 表示 伴生 对 象 的 名 称 
companion object WildAnimalf{ 
fun judgeSex (sexName:String) :Int { 
var sex:Int = when (sexName) { 
" 公 "," 雄 " -> 0 
" 母 "," 舱 ” -> 1 
SEge > = 
1 


return sex 
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以 上 代码 的 judgeSex 方法 在 输入 “ 公 ” 或 者 “ 雄 ” 时 ， 将 返回 0; 输入 “ 母 ”或 者 “上 肉 ” 时 ， 
将 返回 1。 外 部 若 要 调用 该 方法 ， 则 既 可 使 用 完整 的 表达 式 ， 形 如 “WildAnimalCompanion. 
WildAnimaljudgeSex( 名 称 )”， 也 可 使 用 简化 后 的 表达 式 ， 形 如 “WildAnimalCompanion.judgeSex( 名 
称 )”, 后 一 种 方式 看 起 来 就 等 同 于 Java 的 静态 方法 调用 。 下面 是 外 部 调用 judgeSex 方法 的 示例 代码 : 

val sexArray:Array<String> = arrayOf(" 公 "" 母 "," 雄 "，," 肉 ") 
btn companion object.setOnClickListener { 








var sexName:String = sexArray[count++%4] 

// 伴 生 对 象 的 WildAnimal 名 称 可 以 省 略 掉 

//tv_class_member.text = "\"$sexName\" 对 应 的 类 型 是 
${WildAnimalCompanion.WildAnimal .judgeSex (sexName)}" 

tv_class member.text = "\"$sexName\" 对 应 的 类 型 是 
${WildAnimalCompanion.judgeSex (sexName) }" 


} 

以 上 利用 伴生 对 象 间接 实现 了 Kotlin 的 静态 方法 ,演示 代码 的 运行 结果 如 图 5-3 和 图 5-4 所 示 ， 
其 中 图 5-3 所 示 为 判断 “ 公 ” 对 应 性 别 类 型 的 结果 界面 ， 图 5-4 所 示 为 判断 “上 肉 ” 对 应 性 别 类 型 的 
结果 界面 。 


grammar grammar 


me " 公 " 对 应 的 类 型 是 0 





" 叭 "对 应 的 类 型 是 1 


5-3 ”静态 方法 判断 “ 公 ” 的 类 型 取 值 图 54 静态 方法 判断 “ 肉 ” 的 类 型 取 值 


5.2.4 ”静态 属性 


既然 伴生 对 象 能 够 实现 静态 函数 ， 那 么 以 此 类 推 ， 同 样 也 能 实现 静态 属性 ， 只 要 在 伴生 对 象 
内 部 增加 几 个 字段 定义 就 行 。 璧 如 ，judgeSex 方法 通过 数字 0 表示 雄性 ， 通 过 数字 1 表示 雌性 ， 但 
是 只 有 一 个 0 或 1， 压 根 没 法 联想 到 是 雄性 还 是 肉 性 ， 只 能 赁 开发 者 脑袋 的 记忆 ， 当 然 记 忆 往 往 会 
高 混 掉 。 像 这 种 有 特定 含义 的 类 型 数值 , 更 好 的 办 法 是 采取 有 实际 意义 的 常量 名 称 , 比如 在 Android 
中 存在 Color.RED、Color.GREEN、Color.BLUE 等 颜色 常量 ， 从 它们 的 名 称 能 够 直接 联想 到 颜色 
于 是 动物 类 表示 雄性 /雌性 的 0 和 1, 也 可 通过 静态 常量 的 形式 来 表达 , 比如 用 整 型 常量 MALE 
表示 雄性 的 0， 用 FEMALE 表示 雌性 的 1。 具 体 到 Kotlin 编码 上 面 ， 就 是 在 伴生 对 象 中 增加 这 两 
个 常量 字段 的 整 型 数 定义 ， 增 加 字段 定义 后 的 代码 示例 如 下 : 


class WildAnimalConstant (var name:String, val sex:Int = MALE) { 





var sexName:String 
全 区 证 和 
sexName = if(sex==MALE) " 公 " else " 母 " 
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fun getDesc (tag:String) :String { 
return "欢迎 来 到 Stag: 这 只 ${name} 是 ${sexName} 的 。" 
EL 


companion object WildAnimal{ 
// 静 态 常量 的 值 是 不 可 变 的 ， 所 以 要 使 用 关键 字 val 修饰 
val MALE = 0 
Val FEMALE = 1 
val UNKNOWN = -1 
fun judgeSex (sexName:String):Int { 
var sex:Int = when (sexName) { 
" 公 "," 雄 " -> MALE 
" 母 "," 峻 " -> FEMALE 
else -> UNKNOWN 


return sex 


} 


从 以 上 代码 看 到 ,表示 性 别 的 数值 0 都 被 MALE 代替 ,数值 1 被 FEMALE 代替 ， 从 而 提高 了 
代码 的 可 读 性 。 外 部 若 想 进行 动物 性 别 判断 ， 则 可 以 使 用 表达 式 WildAnimalConstant.MALE 表示 
雄性 ， 使 用 WildAnimalConstant.FEMALE 表示 雌性 。 

总 结 一 下 ,Kotlin 的 类 成 员 分 为 实例 成 员 与 静态 成 员 两 种 , 实例 成 员 包括 成 员 属性 和 成 员 方 法 ， 
其 中 与 入 参 同名 的 成 员 属性 可 以 在 构造 函数 中 直接 声明 , 外 部 必须 通过 类 的 实例 才能 访问 类 的 成 员 
属性 和 成 员 方法 。 类 的 静态 成 员 包 括 静 态 属性 与 静态 方法 , 它们 都 在 类 的 伴生 对 象 中 定义 ， 外 部 可 
以 通过 类 名 直接 访问 该 类 的 静态 成 员 。 


5.3 ”类 的 继承 


5.2 节 介绍 了 类 对 成 员 的 声明 方式 与 使 用 过 程 ， 从 而 让 读者 初步 了 解 了 类 的 成 员 及 其 运用 。 不 
过 在 “5.1.1 类 的 简单 定义 ”中 ， 提 到 MainActivity 继承 自 AppCompatActivity， 而 Kotlin 对 于 类 继 
承 的 写法 是 “class MainActivity : AppCompatActivity() f} ”, 这 跟 Java 对 比 有 明显 差异 , 那么 Kotlin 
究竟 是 如 何 定义 基 类 并 由 基 类 派生 出 子 类 呢 ? 为 了 廓 清 这 些 迷 雾 ,本 节 就 对 类 继承 的 相关 用 法 进行 
深入 探讨 。 


5.3.1 ”开放 性 修饰 符 
5.2 节 的 “5.2.1 成 员 属 性 ”在 演示 类 成 员 时 多 次 重 写 了 WildAnimal 类 ,这 下 心急 的 朋友 兴 冲 冲 


地 准备 按照 MainActivity 的 继承 方式 从 WildAnimal 派生 出 一 个 子 类 Tiger, 于 是 写 好 构造 函数 的 两 个 
输入 参数 ， 并 补 上 基 类 的 完整 声明 ， 敲 了 以 下 代码 ， 不 禁 窃 喜 这 么 快 就 大 功 告 成 了 : 
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class Tiger (name:String=" 老 虎 "，sex:Int = 0) : WildAnimal (name, sex) { 
} 


谁 料 编译 器 无 情 地 蹦 出 错误 提示 “The type is final, so it cannot be inherited from”， 意 思 是 
WildAnimal 类 是 final 类 型 ， 所 以 它 不 允许 被 继承 。 原 来 Java 默认 每 个 类 都 能 被 继承 ， 除 非 加 了 关 
键 字 final 表示 终 态 ， 才 不 能 被 其 他 类 继承 。Kotlin 恰恰 相反 ， 它 默认 每 个 类 都 不 能 被 继承 (相当 
于 Java 类 被 final 修饰 了 ) ， 如 果 要 让 某 个 类 成 为 基 类 ， 就 需 把 该 类 开放 出 来 ， 也 就 是 添加 关键 字 
open 作为 修饰 符 。 

因此 ， 接 下 来 还 是 按照 Kotlin 的 规矩 办 事 ， 重 新 写 个 采取 open 修饰 的 基 类 。 下 面 以 鸟 类 Bird 
进行 演示 ， 改 写 后 的 基 类 代码 框架 如 下 : 

open class Bird (var name:String, val sex:Int = 0) { 


// 此 处 暂时 省 略 基 类 内 部 的 成 员 属 性 和 方法 





现在 有 了 基 类 框架 ， 还 得 往 里 面 补 充 成 员 属性 和 成 员 方法 ， 然 后 给 这 些 成 员 添加 开放 性 修饰 
符 。 就 像 读 者 在 Java 世界 中 熟知 的 几 个 关键 字 ， 包 括 public、protected、private， 分 别 表 示 公 开 、 
只 对 子 类 开放 、 和 私有。 那么 Kotlin 体系 参照 Java 也 给 出 了 4 个 开放 性 修饰 符 ， 这 些 修饰 符 的 取 值 
说 明 参 见 表 5-1。 


表 5-1 Kotlin 的 开放 性 修饰 符 的 取 值 说 明 


public 对 所 有 人 开放 。Kotlin 的 类 、 函 数 、 变 量 不 加 开放 性 修饰 符 的 话 ， 默 认 就 是 public 类 型 
只 对 本 模块 内 部 开放 ， 这 是 Kotlin 新 增 的 关键 字 。 对 于 App 开发 来 说 ， 本 模块 便 是 指 App 


自身 
只 对 自己 和 子 类 开放 
只 对 自己 开放 ， 即 私有 





注意 到 这 几 个 修饰 符 与 open 一 样 都 加 在 类 和 函数 前 面 ， 并 且 都 包含 “开放 ”的 意思 ， 乍 看 过 
去 还 真有 点 扑朔迷离 ， 到 底 open 跟 这 4 个 开放 性 修饰 符 是 什么 关系 ? 其 实 很 简单 ，open 不 控制 某 
个 对 象 的 访问 权限 , 只 决定 该 对 象 能 和 否 繁衍 开 来 , 说 白 了 , 就 是 公告 这 个 家 伙 有 没有 资格 生 儿 育 女 。 
只 有 头 戴 open 帽子 的 类 ， 才 允许 作为 基 类 派生 出 子 类 来 ; 而 头 戴 open 帽子 的 函数 ， 表 示 它 允许 在 
子 类 中 进行 重 写 。 如 果 没 戴 上 open 帽子 ， 该 类 就 只 好 打 光 棍 了 ， 无 儿 无 女 ; 函数 没 戴 open 帽子 的 

至 于 那 4 个 开放 性 修饰 符 ， 则 是 用 来 限定 允许 访问 某 对 象 的 外 部 范围 ， 通 俗 地 说 ， 就 是 哪里 
的 帅哥 可 以 跟 这 个 美女 交 朋 友 。 头 戴 public 的 ， 表 示 全 世界 的 帅哥 都 能 跟 她 交 朋 友 ; 头 戴 internal 
的 ， 表 示 只 有 本 国 的 帅哥 可 以 跟 她 交 朋 友 ; 头 戴 protected 的 ， 表 示 只 有 本 单位 以 及 下 属 单位 的 帅 
哥 可 以 跟 她 交 朋 友 ; 头 戴 private 的 ， 表 示 肥 水 不 流 外 人 田 ， 只 有 本 单位 的 帅哥 才能 跟 这 个 美女 交 
朋友 。 

因为 private 的 限制 太 严 厉 了 ， 只 对 自己 开放 ， 甚 至 都 不 允许 子 类 染指 ， 所 以 它 跟 关键 字 open 
势 同 水 火 。open 表示 这 个 对 象 可 以 被 继承 ， 或 者 函数 可 以 被 重 载 ， 然 而 private 却 坚 决 斩 断 该 对 象 
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与 其 子 类 的 任何 关系 , 因此 二 者 不 能 并 存 。 倘若 在 代码 中 强行 给 某 个 方法 同时 加 上 open 和 private， 
编译 器 只 能 无 奈 地 报错 “Modifier 'open' is incompatible with private'”， 意 思 是 open 与 private 二 者 
不 兼容 。 





5.3.2 ”普通 类 继承 


按照 5.3.1 小 节 的 开放 性 相关 说 明 , 接 下 来 分 别 给 Bird 类 的 类 名 、 函数 名 、 变量 名 加 上 修饰 符 ， 
改写 之 后 的 基 类 代码 如 下 所 示 : 


//Kotlin 的 类 默认 是 不 能 继承 的 〈 即 final 类 型 )， 如 果 需 要 继承 某 类， 该 父 类 就 应 当 声 明 为 open 
类 型 
// 和 否则 编译 器 会 报错 “The type is final, so it cannot be inherited from” 
open class Bird (var name:String, val sex:Int = MALE) { 
// 变 量 、 方 法 、 类 默认 都 是 public， 所 以 一 般 都 把 public 省 略 掉 了 
//public var sexName:String 
var sexName:String 
dnit 
sexName = getSexName (sex) 


1 


// 私 有 的 方法 既 不 能 被 外 部 访问 ， 也 不 能 被 子 类 继承 ， 因 此 open 与 Private 不 能 共存 
// 否 则 编译 器 会 报错 : Modifier 'open' is incompatible with 'private' 
//open private fun getSexName (sex:Int):String { 
open protected fun getSexName (sex:Int):String { 

return if(sex==MALE) " 公 " else " 母 " 
E 


fun getDesc (tag:String) :String { 
return "欢迎 来 到 Stag: 这 只 ${name} 是 ${sexName} 的 。" 
} 


companion object BirdStaticf 
val MALE = 0 
val FEMALE = 1 
val UNKNOWN = -1 
fun judgeSex (sexName:String):Int { 
var sex:Int = when (sexName) { 
" 公 "," 雄 " -> MALE 
" 母 ", "上 肉 " -> FEMALE 
else -> UNKNOWN 


return sex 
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好 不 容易 鼓 捣 出 来 一 个 正 儿 八 经 的 鸟 儿 基 类 ， 青 来 声明 一 个 它 的 子 类 试 试 ， 例 如 胸 子 是 鸟 类 
的 一 种 ， 于 是 下 面 有 了 鸭子 的 类 定义 代码 : 

// 注 意 父 类 Bird 已 经 在 构造 函数 声明 了 属性 ， 故 而 子 类 Duck 无 须 重 复 声明 属性 

// 也 就 是 说 ， 子 类 的 构造 函数 在 输入 参数 前 面 不 需要 再 加 val 和 var 

class Duck (name : String=" 了 鸭子 "， sex:Int = Bird.MALE) : Bird(name, sex) 1{ 

} 


回 到 Activity 页 面 代码 ， 按 以 下 代码 调用 新 定义 的 鸭子 类 试 试 : 


btn class duck.setOnClickListener { 
var sexBird = if (count++%3==0) Bird.MALE else Bird.FEMALE 





var duck = Duck (sex=sexBird) 
tv_class inherit.text = duck.getDesc(" 鸟 语 林 ") 
下 


鸭子 类 调用 之 后 的 运行 效果 如 图 5-5 和 图 5-6 所 示 ， 其 中 图 5-5 展示 公 鸭 信息 ， 图 5-6 展示 母 
胸 信 息 。 


grammar grammar 


人 和 这 只 鸭子 是 母 


图 5-5 继承 自 乌 类 的 公 鸭 信息 图 5-6 继承 自 乌 类 的 母 鸭 信息 

子 类 也 可 以 定义 新 的 成 员 属性 和 成 员 方法 ， 或 者 重 写 被 声明 为 open 的 父 类 方法 。 比 方 说 性 别 
名 称 “ 公 ”和 “和 母 ”一 般 用 于 家 禽 ， 像 公鸡 、 母 鸡 、 公 鸭 、 母 鸭 等 ， 而 指 代 野 生 鸟 类 的 性 别 则 通常 
使 用 “ 雄 ” 和 “ 肉 ”。 所 以 定义 野生 鸟 类 的 时 候 ， 就 得 重 写 获取 性 别名 称 的 getSexName 方法 ， 把 
“ 公 ” 和 “ 母 ”的 返回 值 改 为 “ 雄 ” 和 “ 瞧 ”。 
重 写 getSexName 方法 之 后 ， 另 外 定义 一 个 能 鸟 类 的 代码 如 下 所 示 : 
class Ostrich (name:String=" 和 能 鸟 ",，sex:Int = Bird.MALE) : Bird(name, sex) { 

// 继 承 protected 的 方法 ， 标 准 写法 是 “override protected” 

//override protected fun getSexName (Sex:Int) :String { 

// 不 过 protected 的 方法 继承 过 来 默认 就 是 protected， 所 以 也 可 直接 省 略 protected 

//override fun getSexName (sex:Int):String { 

//protected 的 方法 继承 之 后 允许 将 可 见 性 升级 为 pub1lic， 但 不 能 降级 为 private 

override public fun getSexName (sex:Int):String { 

return if (sex==MALE) " 雄 " else "上 肉 " 


本 et 这 只 鸭子 是 公 











} 
} 
然后 在 Activity 代码 中 补充 能 鸟 类 的 方法 调用 ， 具 体 的 调用 代码 如 下 所 示 : 


btn class ostrich.setOnClickListener { 
var SexBird = if (count++%3==0) Bird.MALE else Bird.FEMALE 
Var ostrich = Ostrich (sex=sexBird) 
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tv_class_inherit.text = ostrich.getDesc(" 鸟 语 林 ") 
} 
保存 代码 重新 编译 运行 ， 可 见 通 鸟 类 的 演示 结果 如 图 5-7 和 图 5-8 所 示 ， 其 中 图 5-7 展示 雄 能 
鸟 的 资料 ， 图 5-8 展示 肉 能 鸟 的 资料 。 








人 和 人 








图 5-7 ”继承 自 鸟 类 的 雄 能 鸟 资料 图 5-8 ”继承 自 乌 类 的 肉 能 鸟 资料 
5.3.3 ”抽象 类 


除了 5.3.2 小 节 讲 的 普通 类 继承 ，Kotlin 也 存在 与 Java 类 似 的 抽象 类 ， 抽 象 类 之 所 以 存在 ， 是 
因为 其 内 部 拥有 被 关键 字 abstract 修饰 的 抽象 方法 。 抽 象 方法 没有 有 具体 的 函数 体 ， 故 而 外 部 无 法 直 
接 声 明 抽 象 类 的 实例 ， 只 有 在 子 类 继承 时 重 写 抽象 方法 ， 方 可 使 用 该 子 类 正常 声明 对 象 实例 。 

举 个 例子 ， 鸡 属于 鸟 类 ， 可 公鸡 和 母 鸡 的 叫 声 是 不 一 样 的 ， 公 鸡 是 “ 喔 喔 喔 ”地 叫 ， 而 母 鸡 
是 “ 咯 略 咯 ” 地 叫 。 所 以 鸡 这 个 类 的 叫唤 方法 “callout” 发 出 什么 声音 并 不 确定 ， 只 能 先 声明 为 抽 
象 方法 ， 连 带 着 鸡 类 “Chicken ”也 变 成 抽象 类 了 。 

根据 鸡 类 的 叫 声 抽象 方案 定义 一 个 抽象 的 Chicken 类 ， 代 码 示例 如 下 : 

// 子 类 的 构造 函数 ， 原 来 的 输入 参数 不 用 加 var 和 val， 新 增 的 输入 参数 必须 加 var 或 者 val 

// 因 为 抽象 类 不 能 直接 使 用 ， 所 以 构造 函数 不 必 给 默认 参数 赋值 

abstract class Chicken (name:String, sex:Int, var voice:String) : Bird(name, 
Sex) { 

val numberArray:Array<String> = arrayof ("—", "二 ", "三 ", "四", "五 ", "六 ", "七 
An 

// 抽 象 方法 必须 在 子 类 进行 重 写 , 所 以 可 以 省 略 关键 字 open, 因为 abstract 方法 默认 就 是 open 
类 型 

//open abstract fun callOut (times:Int):String 

abstract fun callOut (times:Int):String 

接着 从 Chicken 类 派生 出 公鸡 类 Cock， 指 定 公鸡 的 声音 为 “ 喔 喔 喔 ”， 同 时 还 要 重 写 callOut 
方法 ， 明 确 公鸡 的 叫唤 行为 。 具 体 的 Cock 类 代码 如 下 所 示 : 

class Cock (name:String=" 鸡 "，sex:Int = Bird.MALE，voice:String=" 喔 喔 唾 ") : 
Chicken (name, sex, voice) { 





override fun callOut (times: Int): String { 
Var count = when { 
//when 语句 判断 大 于 和 小 于 时 ， 要 把 完整 的 判断 条 件 写 到 每 个 分 支 中 
times<=0 -> 0 
times>=10 -> 9 
else -> times 
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return "$sexNameSnameS${fvoice} 叫 了 $fnumberarray [count]} 声 ， 原 来 它 在 报 晓 呀 。" 
1 


同样 派生 而 来 的 母 鸡 类 “Hen” 也 需 指定 母 鸡 的 声音 “咯咯 咯 ”， 并 于 
具体 的 Hen 类 代码 如 下 所 示 : 





写 callOut 叫唤 方法 。 
Chicken (name, sex, 


class Hen (name:String=" 鸡 "，sex:Int = Bird.FEMALE，voice:String=" 咯 咯咯 ") 
voice) { 


Var count = 


override fun callOut (times: Int): String { 
when { 
times<=0 -> 0 

times>=10 -> 9 


else -> times 


} 


return "$sexNameSname${fvoice} 叫 了 $fnumberarray [count] } 声 ， 原 来 它 下 蛋 了 呀 。" 


// 调 用 公鸡 类 的 叫唤 方法 


tv_class_inherit.text 


定义 好 了 callOut 方 法 , 外 部 即 可 调用 Cock 类 和 Hen 类 的 该 方法 了 , 调用 的 例子 代码 如 下 所 示 


btn abstract cock.setOonClickListener { 


= Cock() .callOut (count++%10) 
btn abstract hen.setOnClickListener { 
// 调 用 母 鸡 类 的 叫唤 方法 


tv_class inherit.text 
} 


Hen() .callOut (count++%10) 


梳理 一 下 上 面 的 例子 ， 首 先 定义 了 一 个 包含 抽象 方法 callOut 的 抽象 类 Chicken， 然后 由 该 类 
派生 出 两 个 子 类 ， 分 别 是 公鸡 类 Cock 和 母 鸡 类 Hen， 两 个 子 类 都 重新 实现 了 自己 的 callOut 方 法 ; 
立 | 


最 后 由 外 部 调用 重 写 之 后 的 callOut 方法 。 该 例子 的 演示 界面 如 图 5-9 和 图 5-10 所 示 ， 其 中 图 5-9 
鸡 的 叫唤 行为 ， 图 5-10 显示 母 鸡 的 叫唤 行为 。 








类 继承 信 公鸡 喔 喔 喔 叫 了 十 声 ， 原 来 它 在 报 
息 : 晓 呀 。 


类 继承 信 母 鸡 咯咯 咯 叫 了 九 声 ， 原 来 它 下 蛋 
息 : 了 呀 。 
图 5-9 继承 自 抽象 鸡 类 的 公鸡 叫 声 


5.3.4 接口 





5-10 ”继承 自 抽象 鸡 类 的 母 鸡 叫 声 


既然 提 到 了 抽象 类 , 就 不 得 不 提 接 口 interface。Kotlin 的 接口 与 Java 一 样 是 为 了 间接 实现 多 如 
继承 ， 由 了 








到 


直接 继承 多 个 类 可 能 存在 方法 冲突 等 问题 ， 因 此 Kotlin 在 编译 阶段 就 不 允许 某 个 类 同 
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时 继承 多 个 基 类 ， 和 否则 会 报错 “Only one class may appear in a supertype list”， 意 思 是 继承 列表 中 
只 允许 出 现 一 个 类 。 于 是 乎 ， 只 能 通过 接口 定义 几 个 抽象 方法 ， 然 后 在 实现 该 接口 的 具体 类 中 重 写 
这 几 个 方法 ， 从 而 间接 实现 类 似 C++ 多 重 继承 的 功能 。 

在 Kotlin 中 定义 接口 需要 注意 以 下 几 点 : 


(1) 接口 不 能 定义 构造 函数 ， 否 则 编译 器 会 报错 “An interface may not have a constructor”。 
(2) 接口 的 内 部 方法 通常 要 被 实现 它 的 类 进行 重 写 ， 所 以 这 些 方法 默认 为 抽象 类 型 。 
(3) 与 Java 不 同 的 是 ，Kotlin 允许 在 接口 内 部 实现 某 个 方法 ， 而 Java 接口 的 所 有 内 部 方法 都 
必须 是 抽象 方法 。 
Android 开发 最 常见 的 接口 是 控件 的 点 击 监听 器 View.OnClickListener， 其 内 部 定义 了 控件 的 
点 击 动作 onClick ， 类 似 的 还 有 长 按 监 听 器 View.OnLongClickListener 、 选 择 监听 器 
CompoundButton.OnCheckedChangeListener 等 ， 它 们 无 一 例外 都 定义 了 某 种 行为 的 事件 处 理 过 程 。 
对 于 本 节 的 鸟 类 例子 而 言 , 也 可 通过 一 个 接口 定义 鸟 儿 的 常见 动作 行为 , 譬如 鸟 儿 除了 叫唤 动作 外 ， 
还 有 飞翔 、 游 泳 、 奔 跑 等 动作 ， 有 的 鸟 类 擅长 飞翔 (如 大 雁 、 老 鹰 ) ， 有 的 鸟 类 擅长 游泳 (如 鲍 准 、 
筷 锅 ) ， 有 的 鸟 类 擅长 奔跑 〈 如 能 鸟 、 酌 艇 ) 。 因 此 针对 鸟 类 的 飞翔 、 游 泳 、 奔 跑 等 动作 ， 即 可 声 
明 Behavior 接口 ， 并 在 该 接口 中 定义 几 个 行为 方法 ， 如 fly、swim、run 等 。 
下 面 是 一 个 定义 好 的 行为 接口 的 代码 例子 : 
//Kotlin 与 Java 一 样 不 允许 多 重 继承 ， 即 不 能 同时 继承 两 个 及 两 个 以 上 类 
// 否 则 编译 器 报错 “Only one class may appear in a supertype list” 
// 所 以 仍然 需要 接口 interface 来 间接 实现 多 重 继承 的 功能 
// 接 口 不 能 带 构造 函数 〈 那 样 就 变 成 一 个 类 了 )， 否 则 编译 器 报错 “an interface may not have a 


constructor” 








//interface Behavior (val action:String) { 
interface Behavior { 
// 接 口内 部 的 方法 默认 就 是 抽象 的 ， 所 以 不 加 abstract 也 可 以 ， 当 然 open 也 可 以 不 加 
open abstract fun fly():String 
// 比 如 下 面 这 个 swim 方法 就 没 加 关键 字 abstract， 也 无 须 在 此 处 实现 方法 
fun swim() :String 
//Kotlin 的 接口 与 Java 的 区 别 在 于 ，Kotlin 接口 内 部 允许 实现 方法 
// 此 时 该 方法 不 是 抽象 方法 ， 就 不 能 加 上 abstract 
// 不 过 该 方法 依然 是 open 类 型 ， 接 口内 部 的 所 有 方法 都 默认 是 open 类 型 
fun run() :String { 
return "大 多 数 鸟 儿 跑 得 并 不 像样 ， 只 有 能 鸟 、 酌 竟 等 少数 鸟 类 才 擅 长 奔跑 。" 
//Kotlin 的 接口 允许 声明 抽象 属性 ， 实 现 该 接口 的 类 必须 重 载 该 属性 
/7 与 接口 内 部 方法 一 样 ， 抽 象 属性 前 面 的 open 和 abstract 也 可 省 略 掉 
//open abstract var skilledSports:String 
var SkilledSports:String 
} 


那么 其 他 类 在 实现 Behavior 接口 时 , 跟 类 继承 一 样 把 接口 名 称 放 在 冒号 后 面 ， 也 就 是 说 ，Java 
的 extends 和 implement 这 两 个 关键 字 在 Kotlin 中 都 被 冒号 取代 了 。 然 后 就 像 重 写 抽象 类 的 抽象 方 
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法 一 样 重 写 该 接口 的 抽象 方法 ， 以 定义 鹅 的 Goose 类 为 例 ， 重 写 接口 方法 之 后 的 代码 如 下 所 示 : 


class Goose (name:String=" 鹅 ", sex:Int = Bird.MALE) : Bird(name, sex), Behavior { 





override fun fly() :String { 


return " 鹅 能 飞 一 点 点 ， 但 飞 不 高 ， 也 飞 不 远 。" 
} 


override fun swim():String { 
return " 鹅 ， 鹅 ， 鹅 ， 曲 项 向 天 歌 。 白 毛 浮 绿 水 ， 红 掌 拨 清 波 。" 


// 因 为 接口 已 经 实现 了 run 方法 ， 所 以 此 处 可 以 不 用 实现 该 方法 ， 当 然 你 要 实现 它 也 行 
override fun run() :String { 
//super 用 来 调用 父 类 的 属性 或 方法 ， 由 于 Kotlin 的 接口 允许 实现 方法 ， 因 此 super 所 指 
的 对 象 也 可 以 是 interface 
return super.run() 


. 


// 重 载 了 来 自 接口 的 抽象 属性 
override var skilledSports:String = "游泳 " 
} 


这 下 大 功 告 成 ，Goose 类 声明 的 鹅 不 但 具备 鸟 类 的 基本 功能 ， 而 且 能 飞 、 能 游 、 能 跑 ， 活脱 脱 
一 只 棚 棚 如 生 的 大 白 鹅 呀 。 且 看 下 面 群 忽 千 姿 百 态 的 调用 代码 : 
btn interface _ behavior.setOonClickListener { 
tv_class inherit.text = when (count++%3) { 
0 -> Goose().fly() 
1 -> Goose() .swim() 
else -> Goose() .run() 


上 述 群 鹅 乱 舞 的 界面 如 图 5-11 一 图 5-13 所 示 ， 其 中 5-11 展示 鹅 展 翅 扑 腾 的 效果 ， 图 5-12 展 
示 鹅 游 来 游 去 的 效果 ， 图 5-13 展示 鹅 步履 路 咒 的 效果 。 





类 继承 信 班 能 飞 一 点 点 ， 但 飞 不 高 ， 也 飞 不 a 牧 ， 笋 ， 曲 项 向 天 歌 。 白 毛 浮 让 大 多 数 鸟 儿 跑 得 并 不 像样 ， 只 有 驼 
息 : 远 。 绿 水 ， 红 掌 拨 清 波 。 鸟 、 酌 竟 等 少数 鸟 类 才 擅 长 奔跑 。 





图 5-11 鹅 类 实现 了 飞翔 接口 图 5-12 鹅 类 实现 了 游泳 接口 图 5-13 鹅 类 实现 了 奔跑 接口 


5.3.5 ”接口 代理 


通过 实现 接口 固然 完成 了 相应 行为 ， 但 是 鸟 类 这 个 家 族 非常 庞大 ， 如 果 每 种 鸟 都 要 实现 
Behavior 接口 ， 可 想 而 知 工作 量 是 多 么 巨大 。 其 实 鸟 类 的 行为 并 不 繁多 ,按照 习性 区 分 ， 主要 分 为 
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擅长 飞翔 的 飞禽 、 擅 长 游泳 的 水 禽 、 擅 长 奔跑 的 走 禽 三 类 。 倘 若 依 照 通常 的 处 理 方式 ， 可 从 Bird 
类 与 Behavior 接口 联合 派生 出 三 个 抽象 类 ， 包 括 飞 禽类 、 水 禽类 、 走 禽类 ， 如 此 貌似 解决 了 重复 
实现 接口 的 问题 。 然 而 处 于 不 同 的 环境 之 中 ,同一 只 鸟 儿 可 能 表现 出 不 同 的 行为 ， 比 如 大 雁 既 擅长 
飞翔 又 擅长 游泳 ， 火 鸡 既 擅 长 奔跑 也 能 短 距 离 飞 翔 ， 这 时 抽象 类 的 办 法 就 不 管用 了 。 

为 了 让 各 种 鸟 类 适应 上 述 不 同 场景 的 行为 要 求 , Kotlin 引入 了 接口 代理 的 技术 ,， 即 一 个 类 先 声 
明 继承 自 某 个 接口 , 但 并 不 直接 实现 该 接口 的 方法 , 而 是 把 已 经 实现 该 接口 的 代理 类 作为 参数 传 给 
前 面 的 类 ， 相 当 于 告诉 前 面 的 类 : “该 接口 的 方法 我 已 经 代替 你 实现 了 ， 你 直接 拿 去 用 便 是 ”。 这 
样 做 的 好 处 是 , 输入 参数 可 以 按照 具体 的 业务 场景 传送 相应 的 代理 类 , 也 就 是 说 , 一 只 鸟 儿 怎么 飞 、 
怎么 游 、 怎 么 跑 并 不 是 一 成 不 变 的 ， 而 是 由 实际 情况 决定 的 。 辟 如， 大 雁 越 冬 时 往 南 迁 移 ， 此 时 大 
雁 的 行为 表现 是 飞禽 ; 迁徙 到 目的 地 留 下 来 碗 食 ， 此 时 大 雁 的 行为 表现 是 水 禽 。 

接口 代理 具体 到 Kotlin 编码 上 ， 首 先 要 分 别 定义 飞禽 、 水 禽 、 走 禽 的 三 个 行为 类 ， 下 面 是 飞 
禽 的 行为 类 代码 例子 : 


class BehaviorFly : Behavior { 








override fun fly() :String { 


return " 盘 翔 天 空 " 
, 


override fun swim():String { 


return "落水 凤凰 不 如 鸡 " 


override fun run() :String { 
return "能 飞 干 嘛 还 要 走 " 
Ls 


override var skilledSports:String = "飞翔 " 


下 面 是 水 禽 的 行为 类 代码 例子 : 
class BehaviorSwim : Behavior { 
override fun fly() :String { 
return "看 情况 ， 大 有 奏 能 展翅 高 飞 ， 企 鹅 却 欲 飞 还 休 " 
} 


override fun swim():String { 
return "怡然 戏 水 " 
上 


override fun run() :String { 
return " 赶 鸭 子 上 树 " 
} 


override var skilledSports:String = "游泳 " 
} 


下 面 是 走 禽 的 行为 类 代码 例子 : 
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class BehaviorRun : Behavior { 
override fun fly() :String { 
return " 飞 不 起 来 " 
让 


Override fun swim() :String { 
return " 望 洋 兴 叹 " 


override fun run():String { 
return super.run() 


1 


override var skilledSports:String = "奔跑 " 
} 


接着 定义 一 个 引用 了 代理 类 的 时 禽 基 类 ,通过 关键 字 by 表示 该 接口 将 由 入 参 中 的 代理 类 实现 ， 
时 禽 基 类 WildFowl 的 定义 代码 如 下 所 示 : 


// 只 有 接口 才能 够 使 用 关键 字 by 进行 代理 操作 
// 如 果 by 的 对 象 是 个 类 ， 编 译 器 就 会 报错 “on1y interfaces can be delegated to” 
class WildFowl (name:String, sex:Int=MALE, behavior:Behavior) : Bird(name，sex)， 
Behavior by behavior { 
最 后 介绍 外 部 正常 构造 时 禽类 的 实例 ， 注 意 代理 类 的 入 参 要 传送 具体 的 行为 对 象 ， 之 后 这 只 
野 禽 实例 就 能 很 自如 地 按 设 定好 的 行为 来 飞 呀 、 游 咱 、 跑 趾 。 下 面 是 外 部 调用 时 禽类 WildFowl 的 
具体 行为 代码 例子 : 
btn delegate behavior.setOnClickListener { 
Var fowl = when (count++%6) { 
// 把 代理 类 作为 输入 参数 来 创建 实例 
0 -> WildFowl ("老鹰 "，Bird.MALE, BehaviorFly()) 
// 由 于 sex 字段 是 个 默认 参数 ， 因 此 可 通过 命名 参数 给 behavior 赋值 
1 -> WildFowl ("凤凰 "， behavior=BehaviorFly()) 
2 -> WildFowl(" 大 雁 "，Bird.FEMALE，BehaviorSwim()) 
3 -> WildFowl ("企鹅 "，behavior=BehaviorSwim()) 
4 -> WildFowl ("能 鸟 "，Bird.MALE, BehaviorRun()) 
else -> WildFowl (" 酌 前"，behavior=BehaviorRun ()) 
} 
Var action = when (countSsl1l) { 
in 0..3 -> fowl.fly() 
4,7,10 -> fowl.swim() 
else -> fowl.run() 
} 
tv_ class inherit.text = "${fowl.name}: $action" 
} 


以 上 接口 代理 (或 称 类 代理 ) 代码 的 运行 结果 如 图 5-14 一 图 5-19 所 示 ， 其 中 图 5-14 表示 老鹰 
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的 飞翔 行为 ， 图 5-15 表示 凤凰 的 游泳 行为 ， 图 5-16 表示 大 雁 的 飞翔 行为 ， 图 5-17 表示 企鹅 的 游泳 
行为 ， 图 5-18 表示 能 鸟 的 飞翔 效果 ， 图 5-19 表示 酮 静 的 奔跑 效果 。 


rammar rammar 
9 





人 老鹰 : 刘翔 天 空 ri 凤凰 : 落水 凤凰 不 如 鸡 


图 5-14 ”代理 老鹰 的 飞翔 行为 图 5-15 代理 凤凰 的 游泳 行为 


grammar grammar 


类 继承 信 大 雁 : 看 情况 ， 大 雁 能 展 起 高 飞 ， 类 继承 信 企 执 : 怡然 戏 水 
息 : 企 亚 却 欲 飞 还 休 息 : 


图 5-16 “代理 大 雁 的 飞翔 行为 图 5-17 代理 企鹅 的 游泳 行为 





grammar grammar 


a 类 继承 信 柄 网 ， 大 多 数 久 儿 哆 得 并 不 像样， 
于 ew 启 ， 只 有 如 全 、 确 和 等 少 类 才 担 长 





图 5-18 代理 能 鸟 的 飞翔 行为 图 5-19 ”代理 酌 静 的 奔跑 行为 
总 结 一 下 ，Kotlin 的 类 继承 与 Java 相 比 有 所 不 同 ， 主 要 体现 在 以 下 几 点 : 


(1) Kotlin 的 类 默认 不 可 被 继承 ， 若 需 继承 ， 则 要 添加 open 声明 ;而 Java 的 类 默认 是 允许 
被 继承 的 ， 只 有 添加 final 声明 才 表示 不 能 被 继承 。 

(2) Kotlin 除了 常规 的 三 个 开放 性 修饰 符 public、protected、private 外 ， 另 外 增加 了 修饰 符 
internal， 表 示 只 对 本 模块 开放 。 

(3) Java 的 类 继承 关键 字 extends 以 及 接口 实现 关键 字 implement 在 Kotlin 中 都 被 冒号 所 
取代 。 

(4) Kotlin 允许 在 接口 内 部 实现 某 个 方法 ， 而 Java 接口 的 内 部 方法 只 能 是 抽象 方法 。 

(5) Kotlin 引入 了 接口 代理 〈 类 代理 ) 的 概念 ， 而 Java 不 存在 代理 的 写法 。 


5.4 几 种 特殊 类 


5.3 节 介绍 了 Kotlin 的 几 种 开放 性 修饰 符 以 及 如 何 从 基 类 派生 出 子 类 ， 其 中 提 到 了 被 abstract 
修饰 的 抽象 类 。 除 了 与 Java 共有 的 抽象 类 外 ，Kotlin 还 新 增 了 好 几 种 特殊 类 ， 这 些 特殊 类 分 别 适 
应 不 同 的 使 用 场景 ， 极 大 地 方便 了 开发 者 的 编码 工作 。 下 面 就 来 看 看 Kotlin 在 特殊 类 方面 究竟 提 
供 了 哪些 独门 秘笈 。 
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5.4.1 府 套 类 


一 个 类 可 以 在 单独 的 代码 文件 中 定义 ， 也 可 以 在 另 一 个 类 内 部 定义 ， 后 一 种 情况 叫 作 翌 套 类 ， 
即 A 类 嵌 套 在 B 类 之 中 。 乍 看 过 去 ， 这 个 嵌 套 类 的 定义 似乎 与 Java 的 嵌 套 类 是 一 样 的 ， 但 其 实 有 
所 差别 。Java 的 嵌 套 类 允许 访问 外 部 类 的 成 员 ， 而 Kotlin 的 嵌 套 类 不 允许 访问 外 部 类 的 成 员 。 倘 
若 Kotlin 的 嵌 套 类 内 部 强行 访问 外 部 类 的 成 员 ， 则 编译 器 会 报错 “Unresolved reference: *** ”， 意 
思 是 找 不 到 这 个 东西 。 
下 面 是 Kotlin 在 外 部 类 中 定义 嵌 套 类 的 代码 例子 : 
class Tree (Var treeName:String) { 
// 在 类 内 部 再 定义 一 个 类 ， 这 个 新 类 称 作 嵌 套 类 
class Flower (var flowerName:String) { 
fun getName () :String { 
return "这 是 一 条 $flowerNamen" 
// 普 通 的 嵌 套 类 不 能 访问 外 部 类 的 成 员 ， 如 treeName 
// 否 则 编译 器 报错 “Unresolved reference: ***” 
//return "这 是 ${treeName} 上 的 一 打 $flowerName" 


} 


调用 嵌 套 类 时 ， 得 在 嵌 套 类 的 类 名 前 面 添 加 外 部 类 的 类 名 ， 相 当 于 把 这 个 嵌 套 类 作为 外 部 类 
的 静态 对 象 使 用 。 嵌 套 类 Flower 的 调用 代码 如 下 所 示 : 
btn class nest.setOnClickListener { 
// 使 用 嵌 套 类 时 ， 只 能 引用 外 部 类 的 类 名 ， 不 能 调用 外 部 类 的 构造 函数 
val peachBlossom = Tree.Flower(" 桃 花 ") ; 


tv_class secret.text = PeachBlossom.getName () 
| 


因为 撕 套 类 无 法 访问 外 部 类 的 成 员 ， 所 以 其 方法 只 能 
返回 自身 的 信息 ， 该 例子 中 的 嵌 套 类 调用 结果 如 图 5-20 所 
示 ， 只 看 到 了 花 儿 类 的 花 杀 名 称 。 执行 结果 : 这 是 一 条 桃花 


grammar 








5.4.2 ”内 部 类 图 5-20 嵌 套 类 的 演示 界面 


既然 Kotlin 限制 了 嵌 套 类 不 能 访问 外 部 类 的 成 员 ， 那 还 有 什么 办 法 可 以 实现 此 功能 呢 ? 针对 
该 问题 ，Kotlin 另外 增加 了 关键 字 inner 表示 内 部 ， 把 inner 加 在 嵌 套 类 的 class 前 面 ， 于 是 嵌 套 类 
华丽 地 转变 为 了 内 部 类 ， 这 个 内 部 类 比 起 嵌 套 类 的 好 处 是 能 够 访问 外 部 类 的 成 员 。 所 以 ，Kotlin 的 
内 部 类 就 相当 于 Java 的 嵌 套 类 ， 而 Kotlin 的 嵌 套 类 则 是 加 了 访问 限制 的 内 部 类 。 

仍旧 利用 前 面 演示 嵌 套 类 的 树木 类 Tree， 给 它 补充 内 部 类 Fruit 的 定义 ， 有 具体 代码 如 下 所 示 : 
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class Tree (var treeName:String) { 
// 在 类 内 部 再 定义 一 个 类 ， 这 个 新 类 称 作 嵌 套 类 
class Flower (var flowerName:String) { 
fun getName () :String { 

return "这 是 一 条 $SflowerName" 
// 普 通 的 嵌 套 类 不 能 访问 外 部 类 的 成 员 ， 如 treeName 
// 和 否则 编译 器 报错 “Unresolved reference: ***” 
//return "这 是 ${treeName} 上 的 一 条 $flowerName" 


// 嵌 套 类 加 上 inner 前 级 ， 就 成 为 内 部 类 
inner class Fruit (var fruitName:String) { 
fun getName () :String { 


// 只 有 声明 为 内 部 类 〈 添 加 了 关键 字 inner)， 才 能 访问 外 部 类 的 成 员 
return "这 是 ${treeName} 长 出 来 的 SfruitName" 


} 
调用 内 部 类 时 ， 要 先 实例 化 外 部 类 ， 青 通过 外 部 类 的 实例 调用 内 部 类 的 构造 函数 ， 也 就 是 把 
内 部 类 作为 外 部 类 的 一 个 成 员 对 象 来 使 用 , 这 与 成 员 属 性 、 成员 方 法 的 调用 方法 类 似 。 外 部 调用 内 
部 类 Fruit 的 代码 如 下 所 示 : 
btn_ class_ inner.setOnClickListener { 
// 使 用 内 部 类 时 ， 必 须 调 用 外 部 类 的 构造 函数 ， 否 则 编译 器 会 报错 
val peach = Tree(" 桃 树 ") .Fruit ("桃子 ")， 


tv_class_ secret.text = Peach.getName () 
} 


调用 内 部 类 Fruit 的 演示 结果 如 图 5-21 所 示 , 此 时 水 果 类 的 返回 信息 不 但 包含 自身 的 果实 名 称 ， 
而 且 包 含 树木 类 的 树木 名 称 。 








执行 结果 : 这 是 桃 树 长 出 来 的 桃子 





图 5-21 内 部 类 的 演示 界面 


5.4.3” 枚 举 类 


Java 有 一 种 枚 举 类 型 ， 它 采用 关键 字 enum 来 表达 ， 其 内 部 定义 了 一 系列 名 称 ， 通 过 有 意义 的 
名 字 比 0、1、2 这 些 数字 能 够 更 有 效 地 表达 语义 。 下 面 是 一 个 Java 定义 枚 举 类 型 的 代码 例子 : 


enum Season { SPRING, SUMMER, AUTUMN, WINTER } 
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上 面 的 枚 举 类 型 定义 代码 看 起 来 仿佛 是 一 种 新 的 数据 类 型 ， 特 别 像 枚 举 数组 。 可 是 枚 举 类 型 
实际 上 是 一 种 类 ， 开 发 者 在 代码 中 创建 enum 类 型 时 ，Java 编译 器 会 自动 生成 一 个 对 应 的 类 ， 并 且 
该 类 继承 自 java.lang.Enum。 因 此 ，Kotlin 拨乱反正 ， 据 弃 了 “ 枚 举 类 型 ” 那 种 模糊 不 清 的 说 法 ， 
转 而 采取 “ 枚 举 类 ”这 种 正本 清 源 的 提 法 。 具 体 到 编码 上 ， 是 将 关键 字 enum 作为 class 的 修饰 符 ， 
使 之 名 正言 顺 地 成 为 一 种 类 一 一 枚 举 类 。 

按 此 思路 将 前 面 Java 的 枚 举 类 型 Season 改写 为 Kotlin 的 枚 举 类 ， 改 写 后 的 枚 举 类 代码 如 下 
所 示 : 

enum class SeasonType { 

SPRING, SUMMER, AUTUMN, WINTER 

} 

枚 举 类 内 部 的 枚 举 变量 除了 可 以 直接 拿 来 赋值 之 外 ， 还 可 以 通过 枚 举 值 的 几 个 属性 获得 对 应 
的 信息 ， 例 如 ordinal 属性 用 于 获取 该 枚 举 值 的 序号 ，name 属性 用 于 获取 该 枚 举 值 的 名 称 。 枚 举 变 
量 本 质 上 还 是 该 类 的 一 个 实例 , 所 以 如 果 枚 举 类 存在 构造 函数 , 枚 举 变量 也 必须 调用 对 应 的 构造 函 
数 。 这 样 做 的 好 处 是 ， 每 个 枚 举 值 不 但 携带 唯一 的 名 称 ， 还 可 以 拥有 更 加 个 性 化 的 特征 描述 。 

比如 下 面 的 枚 举 类 SeasonName， 其 代码 通过 构造 函数 能 够 给 枚 举 值 赋予 更 加 丰富 的 含义 : 

enum class SeasonName (val seasonName:String) { 
SPRING ("春天 ")， 
SUMMER ("夏天 ")， 
AUTUMN ("秋天 ")， 
WINTER ("冬天 ") 
} 


下 面 的 代码 分 别 演示 如 何 使 用 枚 举 类 SeasonType 和 SeasonName: 


btn class enum.setOnClickListener { 
if (count%2 == 0) { 
//ordinal 表示 枚 举 类 型 的 序号 ，name 表示 枚 举 类 型 的 名 称 
tv_class secret.text = when (count++%4) { 
SeasonType.SPRING.ordinal -> SeasonType.SPRING.name 
SeasonType.SUMMER.ordinal -> SeasonType.SUMMER.name 
SeasonType.AUTUMN.ordinal -> SeasonType.AUTUMN .name 
SeasonType .WINTER.ordinal -> SeasonType.WINTER.name 
else -> "未 知 " 
} 
和 else 
tv_class_secret.text = when (count++%4) { 
// 使 用 自 定义 属性 seasonName 表示 更 个 性 化 的 描述 
SeasonName.SPRING.ordinal -> SeasonName.SPRING.seasonName 
SeasonName .SUMMER.ordinal -> SeasonName.SUMMER.seasonName 
SeasonName.AUTUMN.ordinal -> SeasonName.AUTUMN .seasonName 
SeasonName .WINTER.ordinal -> SeasonName.WINTER.seasonName 
else -> "未 知 " 
// 枚 举 类 的 构造 函数 是 给 枚 举 类 型 使 用 的 ， 外 部 不 能 直接 调用 枚 举 类 的 构造 函数 





//else -> SeasonName ("未 知 ") .name 


5.4.4 ”密封 类 


5.4.3 小 节 演示 外 部 代码 判断 枚 举 值 的 时 候 ，when 语句 末尾 例行公事 加 了 else 分 支 。 可 是 枚 举 
类 SeasonType 内 部 一 共有 4 个 枚 举 变量 ， 照 理 when 语句 有 4 个 分 支 就 行 了 ， 最 后 的 else 分 支 纯 
粹 是 多 此 一 举 。 出现 此 情况 的 缘故 是 , when 语句 不 晓得 SeasonType 有 4 种 枚 举 值 , 因此 以 防 万 一 ， 
必须 要 有 else 分 支 ， 除 非 编译 器 认为 现 有 的 几 个 分 支 已 经 足够 。 

为 解决 枚 举 值 判断 的 多 余 分 支 问题 ，Kotlin 提出 了 “密封 类 ”的 概念 ， 密 封 类 就 像 是 一 种 更 加 
严格 的 枚 举 类 ， 它 内 部 有 且 仅 有 自身 的 实例 对 象 ， 所 以 是 一 个 有 限 的 自身 实例 集合 。 或 者 说 ， 密 封 
类 采用 了 嵌 套 类 的 手段 ， 它 的 媒 套 类 全 部 由 自身 派生 而 来 ， 仿 佛 一 个 家 谱 ， 明 明白 白地 列 出 某 人 有 
长 子 、 次 子 、 三 子 、 篆 子 。 定 义 密封 类 的 时 候 ， 需 要 在 该 类 的 class 前 面 加 上 关键 字 sealed 作为 标记 。 

还 是 以 5.4.3 小 节 的 四 季 为 例 ， 对 应 的 密封 类 定义 代码 例子 如 下 所 示 : 

sealed class SeasonSealed { 

// 密 封 类 内 部 的 每 个 嵌 套 类 都 必须 继承 该 类 

class Spring (var name:String) : SeasonSealed () 
class Summer (var name:String) : SeasonSealed() 
class Autumn (var name:String) : SeasonSealed () 
class Winter (var name:String) : SeasonSealed () 

} 


这 下 有 了 密封 类 , 外 部 使 用 when 语句 便 无 须 指定 else 分 支 了 。 下 面 是 判断 密封 类 对 象 的 代码 
例子 : 


btn class sealed.setOnClickListener { 
Var season = when (count++%4) { 
0 -> SeasonSealed.Spring ("春天 ") 
1 -> SeasonSealed.Summer ("夏天 ") 
2 -> SeasonSealed.Autumn ("秋天 ") 
else -> SeasonSealed.Winter ("冬天 ") 
} 
// 密 封 类 是 一 种 严格 的 枚 举 类 ， 它 的 值 是 一 个 有 限 的 集合 
// 密 封 类 确保 条 件 分 支 覆盖 了 所 有 的 枚 举 类 型 ， 因 此 不 再 需要 el se 分 支 
tv_class secret.text = when (season) { 
is SeasonSealed.Spring -> season.name 
is SeasonSealed.Summer -> season.name 
is SeasonSealed.Autumn -> season.name 
is SeasonSealed.Winter -> season.name 
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5.4.5 “数据 类 


在 Android 开发 中 ， 免 不 了 经 常 定 义 一 些 存放 数据 的 实体 类 ， 比 如 用 户 信息 、 商 品 信息 等 ， 每 
着 定义 实体 类 之 时 ， 开 发 者 基本 要 手工 完成 以 下 编码 工作 : 

(1) 定义 实体 类 的 每 个 字段 ， 以 及 对 字段 进行 初始 赋值 的 构造 函数 。 

(2) 定义 每 个 字段 的 get/set 方法 。 

(3) 在 判断 两 个 数据 对 象 是 否 相 等 时 ， 通 常 每 个 字段 都 要 比较 一 遍 。 

(4) 在 复制 数据 对 象 时 ， 如 果 想 另外 修改 某 几 个 字段 的 值 ， 得 再 补充 对 应 数量 的 赋值 语句 。 

(5) 在 调试 程序 时 ， 为 获知 数据 对 象 里 保存 的 字段 值 ， 得 手工 把 每 个 字段 值 都 打印 出 来 。 

如 此 折腾 一 番 ， 仅 仅 是 定义 一 个 实体 类 ， 开 发 者 就 必须 完成 这 些 烦 琐 的 任务 。 然 而 这 些 任务 
其 实 毫 无 技术 含量 可 言 , 假设 每 天 都 在 周而复始 地 敲 实 体 类 的 相关 编码 , 毫 无 疑问 跟 工 地 上 搬 砖 的 
民工 差不多 , 活生生 把 程序 员 弄 成 一 个 拼 时 间 、 拼 体力 的 职业 。 鉴 于 此 ，Kotlin 再 次 不 负 众望 地 推 
出 了 名 为 “数据 类 ”的 大 兵器 ， 直 接 戳 中 程序 员 事 多 、 腰 酸 、 睡 眠 少 的 痛 点 ， 极 大 程度 上 将 程序 员 
从 无 涯 苦海 中 拯救 出 来 。 

数据 类 说 神秘 也 不 神秘 , 它 的 类 定义 代码 极其 简单 ,只 要 开发 者 在 class 前面 增加 关键 字 “data”， 
并 声明 拥有 完整 输入 参数 的 构造 函数 ， 即 可 无 颖 实现 以 下 功能 : 

(1) 自动 声明 与 构造 函数 入 参 同名 的 属性 字段 。 

(2) 自动 实现 每 个 属性 字段 的 get/set 方法 。 

(3) 自动 提供 equals 方法 ， 用 于 比较 两 个 数据 对 象 是 否 相等 。 

(4) 自动 提供 copy 方法 ， 允 许 完整 复制 某 个 数据 对 象 ， 也 可 在 复制 后 单独 修改 某 几 个 字段 
的 值 。 

(5) 自动 提供 toString 方法 ， 用 于 打印 数据 对 象 中 保存 的 所 有 字段 值 。 

功能 如 此 强大 的 数据 类 ， 犹 如 步枪 界 的 AK47， 持 有 该 款 自动 步枪 的 战士 无 疑 战 斗 力 倍增 。 见 
识 了 数据 类 的 深厚 功力 ， 再 来 看 看 它 的 类 代码 是 怎么 定义 的 : 

// 数 据 类 必须 有 主 构造 函数 ， 是 至少 有 一 个 输入 参数 

// 并 且 要 声明 与 输入 参数 同名 的 属性 ， 即 输入 参数 前 面 添加 关键 字 val 或 者 var 

// 数 据 类 不 能 是 基 类 也 不 能 是 子 类 ， 不 能 是 抽象 类 ， 也 不 能 是 内 部 类 ， 更 不 能 是 密封 类 

data class Plant (var name:String, var stem:String, var leaf:String, var 
flower:String, var fruit:String, var seed:String) { 

' 

想不到 吧 ， 原 来 数据 类 的 定义 代码 竟然 如 此 简单 ， 当 真是 此 时 无 招 了 性 有 招 。 当 然 ， 为 了 达到 
这 个 代码 精简 的 效果 ， 数 据 类 也 得 遵循 几 个 规则 ， 或 者 说 是 约束 条 件 ， 毕 竟 不 以 规矩 不 成 方圆 ， 正 
如 类 定义 代码 所 注释 的 那样 : 

(1) 数据 类 必须 有 主 构造 函数 ， 且 至 少 有 一 个 输入 参数 ， 因 为 它 的 属性 字段 要 跟 输入 参数 一 
一 对 应 ， 如 果 没 有 属性 字段 ， 这 个 数据 类 保存 不 了 数据 ， 也 就 失去 存在 的 意义 。 

(2) 主 构造 函数 的 输入 参数 前 面 必须 添加 关键 字 val 或 者 var， 这 保证 每 个 入 参 都 会 自动 声明 
同名 的 属性 字段 。 
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(3) 数据 类 有 自己 的 一 套 行 事 规则 ， 所 以 它 只 能 是 个 独立 的 类 ， 不 能 是 其 他 类 型 的 类 ， 否 则 
不 同 规则 之 间 会 产生 冲突 。 


现在 利用 上 面 定义 好 的 数据 类 一 一 植物 类 Plant， 演 示 看 看 外 部 如 何 操作 数据 类 。 下 面 是 外 部 
调用 植物 类 的 具体 代码 : 
var lotus = Plant(" 莲 "，" 莲 稿 "，" 莲 叶 "， "莲花 "，" 莲 莲 "， "莲子 ") 
// 数 据 类 的 copy 方法 不 带 参数 ， 表 示 复 制 一 模 一 样 的 对 象 
var lotus2 = lotus.copy() 
btn class data.setOnClickListener { 
lotus2 = when (count++%2) { 
//copy 方法 带 参数 ， 表 示 指定 参数 另外 赋值 
0 -> lotus.copy (flower=" 荷 花 ") 
else -> lotus.copy (flower=" 莲 花 ") 


} 
// 数 据 类 自 带 equals 方法 ， 用 于 判断 两 个 对 象 是 否 一 样 
var result = if (lotus2.equals (lotus)) "相等 " else "不 等 " 
tv_class_secret .text = "两 个 植物 的 比较 结果 是 ${result}\n" + 
"第 一 个 植物 的 描述 是 ${lotus.tostring()}\n" + 
"第 二 个 植物 的 描述 是 ${lotus2.tostring()}" 


由 此 可 见 ， 上 述 代码 一 口气 调用 了 Plant 对 象 的 copy、equals、toString 等 方法 ， 并 且 这 些 方法 
都 是 数据 类 自动 提供 的 ， 实 实在 在 提高 了 开发 者 的 编码 效率 。 演 示 代 码 的 运行 结果 如 图 5-22 和 图 
5-23 所 示 ， 其 中 图 5-22 所 示 为 两 个 实例 都 是 莲花 时 的 比较 结果 ， 图 5-23 所 示 为 一 个 是 荷花 一 个 是 
莲花 时 的 比较 结果 。 











执行 结果 : ”两 个 植物 的 比较 结果 是 相等 执行 结果 : ”两 个 植物 的 比较 结果 是 不 等 
第 一 个 植物 的 描述 是 第 一 个 植物 的 描述 是 
Plant(name= 莲 , stem= 莲 稿 ， Plant(name= 莲 , stem= 莲 稿 , 
leaf= 莲 叶 , flower= 莲 花 , fruit= 莲 leaf= 莲 叶 , flower= 莲 花 , fruit= 莲 
蓬 , seed= 莲 子 ) 蓬 , seed= 莲 子 ) 
第 二 个 植物 的 描述 是 第 二 个 植物 的 描述 是 
Plant(name= 莲 , stem= 莲 基 ， Plant(name= 莲 , stem= 莲 稿 , 
leaf= 莲 叶 , flower= 莲 花 , fruit= 莲 lea 作 莲 叶 , flower= 荷 花 , fruit= 莲 
蓬 , seed= 莲 子 ) 蓬 , seed= 莲 子 ) 
图 5-22 修改 复制 前 的 数据 类 信息 图 5-23 ”修改 复制 后 的 数据 类 信息 
5.4.6 ”模板 类 


在 第 4 章 的 “4.3.1 泛 型 函数 ”一 节 提 到 泛 型 函数 的 用 法 ,当时 把 泛 型 函数 作为 全 局 函数 定义 ， 
从 而 在 别 的 地 方 也 能 调用 它 。 那 么 如 果 某 个 泛 型 函数 在 类 内 部 定义 ， 即 变 成 了 这 个 类 的 成 员 方法 ， 
又 该 如 何 定义 它 呢 ? 这 个 问题 在 Java 中 是 通过 模板 类 〈 也 叫 作 泛 型 类 ) 来 解决 的 ， 例 如 常见 的 容 
器 类 ArrayList、HashMap 均 是 模板 类 ，Android 开发 中 的 异步 任务 AsyncTask 也 是 模板 类 。 

模板 类 的 应 用 如 此 广泛 ，Kotlin 自然 而 然 保留 了 它 ， 并 且 写 法 与 Java 类 似 ， 一 样 在 类 名 后 面 
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补充 形 如 “<T> ”或 者 “<A, B> ”这样 的 表达 式 ， 表 示 此 处 的 参数 类 型 待定 ， 要 等 创建 类 实例 时 再 
确定 具体 的 参数 类 型 。 待 定 的 类 型 可 以 有 一 个 , 如 ArrayList<T>; 可 以 有 两 个 , 如 HashMap<K,V>; 
也 可 以 有 三 个 或 者 更 多 ， 如 AsyncTask<Params, Progress, Result> 。 
举 个 例子 ,森林 里 有 一 条 小 河 , 小 河 的 长 度 可 能 以 数字 形式 输入 (包括 Int、Long、Float、 Double)， 
也 可 能 以 字符 串 形式 输入 〈String 类 型 )》。 如 果 输 入 的 是 阿拉 伯 数 字 ， 长 度 单位 就 采取 “m”; 如 
果 输 入 的 是 中 文 数字 ， 长 度 单位 就 采取 “ 米 ”。 按 照 以 上 需求 编写 名 为 River 的 模板 类 ， 具 体 的 河 
流 类 定义 代码 如 下 : 
// 在 类 名 后 面 添加 “<T>” 表示 这 是 一 个 模板 类 
class River<T> (var name:String, var length:T) { 
fun getInfo() :String { 
var unit:String = when (length) { 
is String -> " 米 " 
//Int、Long、Float、Double 都 是 数字 类 型 Number 
is Number -> "m" 
else -> "" 
} 
return "${name} 的 长 度 是 $length$unit。" 


} 


外 部 调用 模板 类 构造 函数 的 时 候 ， 要 在 类 名 后 面 补充 “< 参数 类 型 >”， 从 而 动态 指定 实际 的 
参数 类 型 。 不 过 正如 声明 变量 那样 ,如果 编译 器 能 够 根据 初始 值 判断 该 变量 的 类 型 ， 就 无 须 显 式 指 
定 该 变量 的 类 型 。 模 板 类 也 存在 类 似 的 偷懒 写法 ， 若 编译 器 根据 输入 参数 就 能 知晓 参数 类 型 ， 则 调 
用 模板 类 的 构造 函数 也 不 必 显 式 指定 参数 类 型 。 

以 下 是 外 部 使 用 河流 模板 类 的 代码 例子 : 

btn_ class generic.setOnClickListener { 


Var river = when (count++%4) { 
// 模 板 类 ( 泛 型 类 ) 声明 对 和 象 时 ， 要 在 模板 类 的 类 名 后 面 加 上 “< 参数 类 型 >” 
0 -> River<Int>(" 小 溪 "，100) 
// 如 果 编 译 器 根据 输入 参数 就 能 知晓 参数 类 型 ， 也 可 直接 省 略 “< 参 数 类 型 > 
1 -> River(" 瀑 布 "，99.9f) 
// 当 然 保守 起 见 ， 新 手 最 好 按 规 矩 添加 “< 参数 类 型 > 
2 -> River<Double>(" 山 润 "，50.5) 
// 如 果 你 已 经 是 老手 了 ， 怎 么 方便 怎么 来 ，Kotlin 的 设计 初衷 就 是 偷懒 
else -> River(" 大 河 "，" 一 千 ") 

} 

tv _class secret.text = river.getInfo() 

| 


最 后 看 看 河流 类 River 的 几 种 调用 情况 ， 分 别 如 图 5-24 一 图 5-27 所 示 ， 其 中 图 5-24 展示 小 溪 
的 长 度 描 述 文字 ， 图 5-25 展示 瀑布 的 长 度 描述 文字 ， 图 5-26 展示 山涧 的 长 度 描述 文字 ， 图 5-27 
展示 大 河 的 长 度 描述 文字 。 可 见 只 有 大 河 的 长 度 单位 是 中 文 的 “ 米 ”, 其 他 河流 的 长 度 单位 都 是 “<m”。 





执行 结果 ; 小 溪 的 长 度 是 100m。 执行 结果 : 瀑布 的 长 度 是 99.9m。 





图 5-24 小 溪 的 长 度 信息 图 5-25 瀑布 的 长 度 信息 





执行 结果 : 山涧 的 长 度 是 50.5m。 执行 结果 : 大 河 的 长 度 是 一 干 米 。 





图 5-26 ”山涧 的 长 度 信 息 图 5-27 大 河 的 长 度 信息 
5.5 小 结 


本 章 介绍 了 Kotlin 对 类 由 基础 到 高 级 的 定义 及 实现 过 程 ， 包 括 如 何 运用 类 的 几 种 构造 方式 、 
如 何在 类 内 部 定义 成 员 属 性 和 成 员 方法 、 如 何在 类 内 部 正确 使 用 伴生 对 象 、 如 何 实现 类 的 几 种 继承 
方式 〈 包 括 普通 类 、 抽 象 类 、 接 口 、 代 理 等 ) 、 如 何在 不 同 场合 选用 合适 的 特殊 类 等 。 

通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 技能 : 


(1) 学 会 类 的 简单 定义 以 及 主 构造 函数 和 二 级 构造 函数 的 用 法 。 

(2) 学 会 在 类 内 部 定义 成 员 属 性 和 成 员 方 法 ， 并 借助 伴生 对 象 定义 静态 属性 和 静态 方法 。 

(3) 学 会 几 种 开放 性 修饰 符 的 用 法 ， 并 掌握 普通 类 继承 以 及 抽象 类 、 接 口 、 接 口 代理 的 实现 。 

(4) 掌握 常见 的 几 种 特殊 类 的 定义 和 调用 ,包括 嵌 套 类 、 内 部 类 、 枚 举 类 、 密 封 类 、 数 据 类 、 
模板 类 等 。 
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Android 中 的 视图 分 为 两 大 类 ， 一 类 是 布局 ， 另 一 类 是 控件 。 布 局 与 控件 的 区 别 在 于 ， 布 局 本 
质 上 是 个 容器 ， 内 部 还 可 以 放 其 他 视图 (包括 子 布局 和 子 控件 ); 而 控件 是 个 单一 的 实体 ， 已 经 是 
最 后 一 级 ， 下 面 不 能 再 挂 其 他 视图 。 布 局 和 控件 是 Android 初学 者 经 常 接触 的 东西 ， 本 章 就 从 基本 
的 视图 开始 ， 详 细 介绍 如 何 使 用 Kotlin 操作 这 些 简单 的 布局 和 控件 。 


6.1 使 用 按钮 控件 


前 面 几 章 在 演示 Kotlin 语法 的 时 候 ， 多 次 使 用 Button 按钮 控件 来 触发 某 项 动作 。 不 要 小 看 这 
个 小 小 的 按钮 ,里面 可 大 有 玄机 ， 比 方 说 按钮 事件 不 止 点 击 一 种 ， 还 有 长 按 、 选 中 、 取 消 选 中 等 事 
件 ; 再 比如 按钮 事件 的 实现 代码 ， 又 有 匿名 函数 、 内 部 类 、 接 口 实现 等 方式 ， 另外， 按钮 家 族 除了 
常见 的 Button 控件 外 ， 还 有 复 选 框 CheckBox、 单 选 按钮 RadioButton 等 其 他 特殊 按钮 。 原 来 看 似 
简单 的 按钮 ， 竞 然 存 在 这 么 多 的 学 问 ， 赶 紧 来 看 看 Kotlin 是 如 何 使 用 各 种 按钮 控件 的 。 


6.1.1 按钮 Button 


Button 是 Android 常用 的 控件 之 一 , 事实 上 按钮 也 是 各 大 平台 通用 的 基本 控件 , 无 论 打开 一 个 
电脑 程序 还 是 手机 App， 都 会 遇 到 “确定 ”“ 取 消 ”“ 注 册 ”“ 登 录 ” 等 按钮 ， 这 些 按钮 的 用 途 也 
很 直 白 ， 都 是 用 户 点 击 一 下 触发 某 项 动作 。 比 如 下 面 这 行 Kotlin 代码 便 是 一 个 简单 的 按钮 点 击 事 
件 的 例子 : 








btn click.setOnClickListener { btn click.text=" 您 点 J 一 下 下 " } 


按钮 的 长 按 事 件 处 理 与 点 击 事件 大 同 小 异 , 区 别 在 于 长 按 代 码 末 尾 多 了 返回 true, 长 按 事 件 具 
体 的 Kotlin 代码 示例 如 下 : 
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btn click long.setOnLongClickListener { btn click long.text=" 您 长 按 了 
一 小 会 "; true } 

上 面 的 两 种 按钮 事件 代码 其 实 是 简化 最 彻底 的 表达 形式 。 因 为 点 击 事件 和 长 按 事件 本 来 存在 
输入 参数 , 它们 的 入 参 是 发 生 了 点 击 和 长 按 动 作 的 视图 对 象 , 所 以 完整 的 事件 处 理 代 码 应 当 保留 视 
图 对 象 这 个 输入 参数 。 只 不 过 由 于 多 数 情况 用 不 到 视图 对 象 ， 因 此 在 Kotlin 中 把 元 余 的 视图 入 参 
给 省 略 了 。 但 是 为 了 弄 清楚 按钮 事件 的 来 龙 去 脉 ,还 是 有 必要 观察 一 下 它 的 本 来 面貌 ， 接 下 来 依次 
介绍 按钮 事件 的 三 种 Kotlin 编码 方式 : 匿名 函数 、 内 部 类 、 接 口 实现 。 


1. 匿名 函数 方式 
辟 如 ， 现 在 准备 响应 按钮 的 点 击 事件 ， 在 点 击 按钮 的 同时 提示 该 按钮 的 名 称 ， 此 时 点 击 事件 
的 内 部 代码 就 得 获取 视图 对 象 的 文本 。 下 面 是 补充 了 视图 入 参 的 Kotlin 代码 例子 : 
// 点 击 事件 第 一 种 : 匿名 函数 方式 


btn click anonymos.setOnClickListener { V -> 


//Kotlin 对 变量 进行 类 型 转换 的 关键 字 是 as 
toast ("您 点 击 了 控件 : ${ (v as Button) .text}") 
} 


由 此 可 见 ， 点 击 事件 的 函数 代码 被 符号 “->” 分 成 了 两 部 分 ， 前 一 部 分 的 “v” 表 示 发 生 了 点 
击 动作 的 视图 入 参 ， 其 类 型 为 View; 后 一 部 分 则 为 处 理 点 击 事件 的 具体 函数 体 代码 。 此 处 的 函数 
体 代码 中 还 有 两 个 值得 注意 的 地 方 : 


(1) 因为 视图 View 是 基本 的 视图 类 型 ， 并 不 存在 文本 属性 ， 所 以 需要 把 这 个 视图 对 象 的 变 
量 类 型 转换 为 按钮 Button， 然 后 才能 得 到 按钮 对 象 的 文本 。Kotlin 中 的 类 型 转换 是 通过 关键 字 as 
实现 的 ， 具 体 的 转换 格式 形 如 “ 待 转换 的 变量 名 称 as 转换 后 的 类 型 名 称 ”。 

(2) 由 于 待 显示 的 字符 串 需要 拼接 按钮 文本 ， 因 此 需要 通过 字符 串 模板 表达 式 “${***}” 将 
按钮 文本 置 入 该 字符 串 。 


这 下 有 了 包含 输入 参数 的 点 击 事件 代码 ， 书 写 包含 入 参 的 长 按 事件 代码 即 可 依 样 画 葫芦 ， 完 
整 的 Kotlin 长 按 代码 示例 如 下 : 

// 点 击 事件 第 一 种 : 匿名 函数 方式 

btn click anonymos.setOnLongClickListener { v -> 
//Kotlin 对 变量 进行 类 型 转换 的 关键 字 是 as 
longToast ("您 长 按 了 控件 : ${ (v as Button) .text}") 
true 

} 


以 上 带 入 参 的 函数 处 理 代 码 构成 了 按钮 事件 的 第 一 种 写法 一 一 匿名 函数 方式 ， 当 然 也 是 编码 
最 简洁 的 一 种 方式 。 
2. 内 部 类 方式 


匿名 函数 方式 直接 把 事件 代码 写 在 setOnClickListener 方法 后 面 ， 如 果 代 码 不 多 倒 还 凌 合 ， 要 
是 代码 很 多 那 就 尴 估 了 ， 只 一 个 方法 调用 就 会 占 去 大 量 篇 幅 ， 着 实 显得 大 腹 便 便 。 故 而 对 于 包含 较 
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多 行 代码 的 事件 处 理 , 往往 给 它 单独 定义 一 个 内 部 类 , 这 样 该 事件 的 处 理 代码 被 完全 封装 在 内 部 类 
之 中 ， 能 够 有 效 增强 代码 的 可 读 性 。 
就 前 面 的 点 击 事件 和 长 按 事 件 而 言 ， 可 以 给 它们 分 别 定义 对 应 的 监听 器 内 部 类 ， 下 面 便 是 点 
击 监听 器 内 部 类 以 及 长 按 监听 器 内 部 类 的 Kotlin 定义 代码 例子 : 
// 点 击 事件 第 二 种 : 内 部 类 方式 
Private inner class MyClickListener : View.OnClickListener { 


override fun onClick(v: View) { 
toast ("您 点 击 了 控件 : ${ (v as Button) .text}") 





} 


Private inner class MyLongClickListener : View.OnLongClickListener { 
override fun onLongClick(v: View): Boolean { 
longToast ("您 长 按 了 控件 : ${ (v as Button) .text}") 
return true 


定义 了 事件 处 理 的 内 部 类 之 后 ， 按 钮 控件 在 调用 setOnClickListener 方法 或 者 调用 
setOnLongClickListener 方法 之 时 ， 即 可 直接 传 入 相应 内 部 类 的 对 象 实例 ， 具 体 调用 的 Kotlin 代码 
如 下 所 示 : 
// 点 击 事件 第 二 种 ， 内 部 类 方式 
btn click inner.setOnClickListener (MyClickListener()) 
btn click inner.setOnLongClickListener (MyLongClickListener()) 


从 上 面 的 调用 代码 看 到 ， 方 法 内 部 的 输入 参数 为 内 部 类 定义 的 监听 器 实例 。 既 然 对 象 实例 可 
以 多 次 构造 , 这 也 就 意味 着 内 部 类 方式 允许 被 不 同 控件 多 次 调用 , 因此 很 大 程度 上 提高 了 事件 处 理 
代码 的 复 用 性 。 


3. 接口 实现 方式 

内 部 类 方式 固然 使 事件 代码 更 加 灵活 ， 可 如 果 每 个 事件 都 定义 新 的 内 部 类 ， 要 是 某 个 页 面 上 
多 个 控件 都 需要 监听 对 应 的 事件 处 理 , 该 页 面 的 活动 代码 势必 得 定义 一 大 堆 监听 器 内 部 类 , 仍 会 造 
成 拥挤 不 堪 的 代码 局 面 。 所 以 处 理 监 听 事 件 的 第 三 种 方式 一 一 接口 实现 方式 便 应 运 而 生 ， 该 方式 让 
页 面 的 Activity 类 实现 事件 监听 器 的 接口 ， 并 重 写 监 听 器 的 接口 方法 ， 使 得 这 些 接口 方法 就 像 是 
Activity 类 的 成 员 方法 一 样 ， 并 且 可 以 毫 无 障碍 地 访问 该 Activity 类 的 所 有 成 员 属性 和 成 员 方 法 。 

接口 的 概念 及 其 具体 实现 参见 第 5 章 的 “5.3.4 接口 ”。 下 面 是 在 Activity 类 采取 接口 方式 实 
现 点 击 事件 和 长 按 事 件 的 代码 例子 : 

class ButtonClickActivity : AppCompatActivity(), OnClickListener, 
OnLongClickListener { 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity button click) 
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// 点 击 事件 第 三 种 :Activity 实现 接口 

btn click interface.setOnClickListener (this) 

btn click interface.setOnLongClickListener (this) 
} 


// 点 击 事件 第 三 种 : Activity 实现 接口 
override fun onClick(v: View) { 
if (v.id == R.id.btn click interface) { 
toast ("您 点 击 了 控件 : ${ (v as Button) .text}") 
h 
和 


override fun onLongClick(v: View): Boolean { 
if (v.id == R.id.btn click interface) { 
longToast ("您 长 按 了 控件 : ${ (v as Button) .text}") 
} 


return true 


， 接 口 实现 方式 更 适用 于 事件 代码 较 多 、 较 复杂 的 情况 。 总 之 ， 处 理 按钮 控件 的 点 击 和 
长 按 : 本 具体 采取 哪 各 Kotlin 编码 方式 ， 还 是 由 实际 的 业务 情况 来 决定 


6.1.2 ” 复 选 框 CheckBox 


复 选 框 用 于 检查 有 没有 选中 的 控件 ， 该 控件 要 么 是 选中 状态 ， 要 么 是 取消 选中 状态 ， 因 此 常常 
用 于 判断 “是 否 ***” 的 场合 ， 比 如 “是 否 记 住 密码 ”“ 是 否 同意 条 款 ”“ 是 否 选择 全 部 ”等 情况 。 

在 学 习 复 选 框 的 用 法 之 前 , 先 了 解 一 下 复合 按钮 CompoundButton 的 概念 。 在 Android 体系 中 ， 
CompoundButton 类 是 抽象 的 复合 按钮 ， 因 为 是 抽象 类 ， 所 以 并 不 能 直接 使 用 。 实 际 开 发 中 用 的 是 
它 的 几 个 派生 类 ， 主 要 有 复 选 框 CheckBox、 单 选 按钮 RadioButton 以 及 开关 按钮 Switch， 这 些 派 
生 类 均 可 使 用 CompoundButton 的 属性 和 方法 。 

Android 处 理 复合 按钮 的 色 选 状态 有 两 个 Java 方法 : setChecked 和 isChecked, 其 中 setChecked 
方法 用 于 设置 按钮 的 勾 选 状态 ， 而 isChecked 方法 用 于 判断 按钮 是 否 勾 选 。 但 在 Kotlin 编码 中 ， 这 
两 个 方法 被 统一 成 isChecked 属性 ， 修 改 isChecked 的 属性 值 即 为 设置 按钮 的 勾 选 状态 ， 而 获取 
isChecked 的 属性 值 即 为 判断 按钮 是 否 色 选 。 对 于 这 种 将 两 个 方法 合 二 为 一 的 按钮 状态 属性 , Kotlin 
还 有 好 些 类 似 的 情况 ， 具 体 的 对 应 方法 与 属性 说 明 参 见 表 6-1。 


表 6-1 两 个 状态 方法 合并 为 一 个 状态 属性 的 Kotlin 与 Java 对 照 
按钮 控件 的 属性 说 明 Kotlin 的 状态 属性 Java 的 状态 获取 与 设置 方法 
是 否 勾 选 isChecked isChecked/setChecked 
是 否 允许 点 击 isClickable isClickable/setClickable 
是 否 可 用 isEnabled isEnabled/setEnabled 
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( 续 表 ) 
按钮 控件 的 属性 说 明 Kotlin 的 状态 属性 Java 的 状态 获取 与 设置 方法 
是 否 获 得 焦点 isFocusable isFocusable/setFocusable 
是 否 按 下 isPressed isPressed/setPressed 
是 否 允许 长 按 isLongClickable isLongClickable/setLongClickable 





是 否 选择 isSelected isSelected/setSelected 


复 选 框 CheckBox 是 复合 按钮 的 一 个 简单 实现 ， 点 击 复 选 框 则 勾 选 ， 再 次 点 击 则 取消 勾 选 。 
CheckBox 通过 setOnCheckedChangeListener 方法 设置 勾 选 监听 器 ， 下 面 是 使 用 复 选 框 自 定义 勾 选 
监听 器 的 Kotlin 代码 例子 : 


class CheckboxActivity : AppCompatActivity() { 





override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity checkbox) 
ck_select.isChecked = false // 默 认 是 未 选中 状态 
ck_select .setOnCheckedChangeListener { buttonView, isChecked -> 
tv_select.text = "您 ${ if (isChecked) " 勾 选 ”else "取消 勾 选 "} 了 复 选 框 " 
} 


} 
这 里 的 复 选 框 演示 代码 主要 运用 了 匿名 函数 、 简 单 分 支 的 让 语句 以 及 字符 串 模 板 等 Kotlin 基 


语法 。 对 应 的 复 选 框 演示 效果 如 图 6-1 和 图 6-2 所 示 ， 其 中 图 6-1 所 示 为 勾 选 后 的 界面 ， 图 6-2 
所 示 为 取消 勾 选 后 的 界面 。 





simple 





这 是 个 复 选 杠 口 这 是 个 复 选 框 
您 勾 选 了 复 选 杠 您 取消 勾 选 了 复 选 杠 








图 6-1 勾 选 了 复 选 框 的 效果 图 6-2 ”取消 勾 选 之 后 的 效果 


6.1.3 ” 单 选 按钮 RadioButton 


单 选 按钮 要 在 一 组 按钮 中 选择 其 中 一 项 ， 并 且 不 能 多 选 ， 这 要 求 有 个 容器 确定 这 组 按钮 的 范 
围 ,这 个 容器 便 是 单 选 组 RadioGroup。 单 选 组 RadioGroup 实质 上 是 一 个 布局 ,同一 组 的 RadioButton 
都 要 放 在 同一 个 RadioGroup 节点 之 下 。RadioGroup 拥有 orientation 属性 ， 可 指定 下 级 控件 的 排列 
方向 ， 该 属性 为 horizontal 时 ， 单 选 按钮 就 在 水 平方 向 上 排列 ， 该 属性 为 vertical 时 ， 单 选 按钮 就 
在 垂直 方向 上 排列 。 并 且 RadioGroup 下 面 除 了 RadioButton 外 ， 也 可 以 挂 载 其 他 子 控件 ， 如 
TextView、ImageView 等 ， 这 样 看 来 ， 它 就 是 一 个 特殊 的 线性 布局 ， 只 不 过 多 了 一 个 管理 单 选 按钮 
的 功能 。 
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单 选 按钮 RadioButton 默认 是 未 选中 状态 ， 点 击 它 则 显示 选中 状态 ， 但 是 再 次 点 击 并 不 会 取消 
选中 。 只 有 点 击 同 组 的 其 他 单 选 按钮 ， 原 来 选中 的 单 选 按钮 才 会 被 取消 选中 。 另 外 ， 单 选 按钮 的 选 
中 事件 一 般 不 由 RadioButton 响应 ， 而 是 由 RadioGroup 来 响应 。 单 选 按钮 的 选中 事件 在 实现 的 时 
候 ， 首 先 写 一 个 选中 监听 器 实现 接口 RadioGroup.OnCheckedChangeListener， 然 后 调用 RadioGroup 
对 象 的 setOnCheckedChangeListener 方法 来 注册 该 监听 器 。 

下 面 是 一 个 RadioGroup 实现 选中 监听 器 的 Kotlin 代码 例子 : 





class RadioButtonActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity radio button) 
rg_ sex.setOnCheckedChangeListener { group, checkedId -> 
tv_sex.text = when (checkedId) { 
R.id.rb male ->" 哇 哦 ， 你 是 个 帅气 的 男孩 " 
R.id.rb female -> " 哇 哦 ， 你 是 个 漂亮 的 女孩 " 


else -> "" 


} 

由 此 可 见 ， 单 选 按钮 的 演示 代码 运用 了 匿名 函数 以 及 多 路 分 支 的 when 语句 。 对 应 的 单 选 演示 
效果 如 图 6-3 和 图 6-4 所 示 ， 其 中 图 6-3 所 示 为 选中 左 侧 按钮 后 的 界面 ， 图 6-4 所 示 为 选中 右 侧 按 
钮 后 的 界面 。 
simple 


请 选择 您 的 性 别 


〇 男 @ 女 


哇 哦 ， 你 是 个 帅气 的 男孩 哇 哦 ， 你 是 个 漂亮 的 女孩 





图 6-3 选中 左 侧 按钮 的 效果 图 64 选中 右 侧 按钮 的 效果 

总 结 一 下 ， 本 节 介 绍 了 常见 的 三 种 按钮 控件 的 用 法 ， 并 复习 了 Kotlin 的 一 些 基 本 语法 知识 ， 
包括 : 

(1) Kotlin 的 匿名 函数 用 法 。 

(2) Kotlin 的 内 部 类 用 法 。 

(3) Kotlin 的 接口 实现 办 法 。 

(4) Kotlin 的 字符 串 模板 写法 。 

(5) Kotlin 简单 分 支 与 多 路 分 支 的 表达 式 。 


另外 ， 学 习 了 Kotlin 的 类 型 转换 关键 字 as 的 用 法 。 
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6.2 ”使 用 页 面 布局 


布局 视图 有 很 多 种 , 各 自 规定 了 内 部 下 级 视图 的 排列 与 对 齐 方 式 , 包括 线性 布局 LinearLayout、 
相对 布局 RelativeLayout、 框 架 布 局 FrameLayout 等 ， 以 及 后 起 之 秀 约束 布局 ConstraintLayout。 本 
节 对 常用 的 两 种 布局 一 一 线性 布局 和 相对 布局 进行 说 明 ， 另 外 介绍 使 用 约束 布局 的 一 些 注意 事项 。 





6.2.1 线性 布局 LinearLayout 


顾名思义 ， 线 性 布局 下 面 的 子 视图 像 是 用 一 根 线 串 起 来 ， 所 以 其 内 部 视图 的 排列 是 有 顺序 的 ， 
要 么 从 上 到 下 垂直 排列 , 要 么 从 左 到 右 水 平 排列 。 不 过 排列 顺序 只 能 指定 一 维 方 向 的 视图 次 序 ， 可 
手机 屏幕 是 一 个 二 维 的 平面 , 这 意味 着 还 剩 另 一 维 方向 需要 指定 视图 的 对 齐 方式 。 故 而 线性 布局 主 
要 有 以 下 两 种 属性 设置 方法 。 

(1) setOrientation: 设置 内 部 视图 的 排列 方向 。LinearLayout.HORIZONTAL 表示 水 平 布局 ， 
LinearLayout.VERTICAL 表示 垂直 布局 。 

(2) setGravity: 设置 内 部 视图 的 对 齐 方式 ， 对 齐 方式 的 取 值 说 明 见 表 6-2。 

表 6-2 ”对齐 方式 的 取 值 说 明 








Gravity 类 的 对 齐 方式 说 明 

Gravity LEFT 向 左 对 齐 
GravityRIGHT 向 右 对 齐 
Gravity.TOP 向 上 对 齐 
Gravity. BOTTOM 向 下 对 齐 
Gravity.CENTER 居中 对 齐 











空白 距离 margin 和 间隔 距离 padding 是 另外 两 个 常见 的 视图 概念 ，margin 指 的 是 当前 视图 与 
周围 视图 的 距离 ， 而 padding 指 的 是 当前 视图 与 内 部 视图 的 距离 。 这 么 说 可 能 有 些 抽象 ， 接 下 来 还 
是 做 个 实验 , 看 看 它们 的 显示 效果 到 底 有 什么 不 同 。 下 面 是 一 个 实验 用 的 布局 文件 内 容 , 通过 背景 
色 观 察 每 个 视图 的 区 域 范围 : 








<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match Parent" 
android:layout height="match parent" 
android:orientation="vertical" > 
<!-- 外 层 布局 的 背景 色 是 蓝 色 --> 
<LinearLayout 
android:layout width="match parent" 
android:layout height="300dp" 
android:background="#00aaff" > 
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<!-- 中 间 布 局 的 背景 色 是 黄色 --> 
<LinearLayout 
android:id="e@+id/11 margin" 
android:layout width="match parent" 
android:layout height="match Parent" 
android:background="#ffff99" > 
<!-- 内 层 视 图 的 背景 色 是 红色 --> 
<View 
android:layout width="match Parent" 
android:layout height="match parent" 
android:background="#ff0000" /> 
</LinearLayout> 
</LinearLayout> 
</LinearLayout> 


与 上 述 布 局 文件 对 应 的 页 面 Kotlin 代码 如 下 所 示 ， 目 的 是 根据 不 同 的 按钮 分 别 设置 不 同方 向 
上 的 margin 和 padding 数值 : 


// 该 页 面 用 于 演示 margin 和 padding 的 区 别 
class LinearLayoutActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView (R.layout.activity linear layout) 
// 设 置 11_margin 内 部 视图 的 排列 方式 为 水 平 排列 
11 margin.orientation = LinearLayout .HORIZONTAL 
// 设 置 11_margin 内 部 视图 的 对 齐 方式 为 居中 对 齐 
11 margin.gravity = Gravity.CENTER 
btn margin vertical.setOnClickListener { 
//Kotlin 对 变量 进行 类 型 转换 的 关键 字 是 as 
val params = 1]1] margin.layoutParams as LinearLayout.LayoutParams 
//setMargins 方法 为 设置 该 视图 与 外 部 视图 的 空白 距离 
// 此 处 设置 左边 和 右边 的 margin 空白 距离 为 50dp 
Params .setMargins (0, dip(50), 0, dip(50)) 
11] margin.layoutParams = params 
} 
btn margin horizontal.setOnClickListener { 
val params = 1]1 margin.layoutParams as LinearLayout.LayoutParams 
// 此 处 设置 顶部 和 底部 的 margin 空白 距离 为 50dp 
Params.setMargins (dip(50), 0, dip(50), 0) 
11 margin.layoutParams = params 
} 
//setPadding 方法 为 设置 该 视图 与 内 部 视图 的 间隔 距离 
btn padding vertical.setOnClickListener { 
// 此 处 设置 左边 和 右边 的 padding 间隔 距离 为 50dp 
11_margin.setPadding(0，dip(50)，0，dip(50)) 
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} 
btn padding horizontal.setOnClickListener { 
// 此 处 设置 顶部 和 底部 的 padding 间隔 距离 为 50dp 
11 margin.setPadding (dip(50), 0, dip(50), 0) 


} 


演示 过 程 中 ， 一 开始 整个 视图 是 红色 的 ， 先 按 下 第 一 个 按钮 ， 视 图 项 部 和 底部 各 出 现 一 段 蓝 
色 区 域 ， 如 图 6-5 所 示 。 接 着 按 下 第 二 个 按钮 ， 视 图 项 部 和 底部 的 蓝 色 消 失 ， 取 而 代 之 出 现 了 左边 
和 右边 的 蓝 色 区 域 , 如 图 6-6 所 示 。 前 面 这 两 种 情况 表明 setMargins 方法 控制 着 当前 视图 与 外 层 视 
图 的 间隔 距离 。 





红色 色 ” 蓝 色 蓝 色 
垂直 方向 MARGIN 水 平方 向 MARGIN 垂直 方向 MARGIN 水 平方 向 MARGIN 
垂直 方向 PADDING 。 水 平方 向 PADDING 垂直 方向 PADDING 。 水 平方 向 PADDING 

图 6-5 按 下 第 一 个 按钮 的 线性 布局 效果 图 6-6 按 下 第 二 个 按钮 的 线性 布局 效果 


再 按 下 第 三 个 按钮 ， 此 时 左右 两 边 的 蓝 色 区 域 不 变 ， 但 中 间 的 红色 区 域 上 方 和 下 方 各 出 现 一 
段 黄色 ， 如 图 6-7 所 示 。 最 后 按 下 第 四 个 按钮 ， 可 见 上 方 和 下 方 的 黄色 消失 ， 改 到 了 在 蓝 色 和 红色 
区 域 之 间 出 现 黄色 ,如 图 6-8 所 示 。 后 面 两 种 情况 表明 setPadding 方法 控制 着 当前 视图 与 内 层 视图 
的 间隔 距离 。 





Simple 





重 直 方向 MARGIN 水 平方 向 MARGIN 垂直 方向 MARGIN ”水 平方 向 MARGIN 


垂直 方向 PADDING 。 水 平方 向 PADDING 垂直 方向 PADDING 。 水 平方 向 PADDING 


图 6-7 按 下 第 三 个 按钮 的 线性 布局 效果 图 6-8 按 下 第 四 个 按钮 的 线性 布局 效果 
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依据 前 面 的 页 面 代码 演示 的 例子 ，Kotlin 代码 与 Java 代码 的 写法 有 以 下 三 点 区 别 : 


(1) Kotlin 允许 对 属性 orientation 直接 赋值 ， 从 而 取代 了 setOrientation 方法 ;类 似 的 还 有 属 
性 gravity 取代 了 setGravity 方法 。 
(2) Kotlin 使 用 关键 字 as 进行 变量 的 类 型 转换 操作 。 
(3) Kolin 支持 调用 dip 方法 将 dip 数值 转换 为 px 数值 ， 倘 若 由 Java 编码 ， 则 需 开 发 者 自己 
实现 一 个 像素 转换 的 工具 类 。 下 面 是 实现 像素 转换 的 Java 工具 类 代码 例子 : 
public class Utils { 
// 根 据 手 机 的 分 辨 率 从 dp 的 单位 转 成 为 px (像素 ) 
Public static int dip2px (Context context, float dpValue) { 
final float scale = context.getResources() .getDisplayMetrics() 


.density; 
return (int) (dpValue * scale + 0.5f); 


// 根 据 手 机 的 分 辨 率 从 px (像素 ) 的 单位 转 成 为 dp 
Public static int px2dip(Context context, float pxValue) { 
final float scale = context.getResources() .getDisplayMetrics() 
.density; 
return (int) (pxValue / scale + 0.5f); 


} 
} 


因为 演示 代码 里 的 dip 方法 来 自 于 Kotlin 扩展 的 Anko 库 ， 所 以 需要 在 Activity 代码 头 部 加 入 
下 面 一 行 导入 语句 : 

import org.jetbrains.anko.dip 

既然 用 到 了 Anko 库 ， 自 然 要 修改 模块 的 build.gradle， 在 dependencies 节点 中 补充 下 述 的 
anko-common 包 编译 配置 : 

compile "org.jetbrains .anko:anko-common:S$Sanko_Vversion" 

Anko 库 除了 提供 dip 方法 外 ， 还 提供 了 sp、px2dip、px2sp、dimen 等 像素 单位 的 转换 方法 ， 

具体 的 方法 说 明 见 表 6-3。 
表 6-3 Anko 库 的 像素 单位 转换 方法 说 明 




















Anko 库 的 像素 单位 转换 方法 说 明 

dip 将 dip 单位 的 数值 转换 为 以 px 为 单位 的 数值 
sp 将 sp 单位 的 数值 转换 为 以 px 为 单位 的 数值 
px2dip 将 px 单位 的 数值 转换 为 以 dip 为 单位 的 数值 
px2sp 将 px 单位 的 数值 转换 为 以 sp 为 单位 的 数值 
dimen 将 dip 单位 的 数值 转换 为 以 sp 为 单位 的 数值 
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6.2.2 ”相对 布局 RelativeLayout 





由 于 线性 布局 的 视图 排列 方式 比较 固定 ， 既 不 能 重 登 显示 也 不 能 灵活 布局 ， 因 此 复杂 一 些 的 
界面 往往 用 到 相对 布局 RelativeLayout。 相 对 布局 内 部 的 视图 位 置 不 依赖 于 排列 规则 ， 而 依赖 于 指 
定 的 参照 物 ， 这 个 参照 物 可 以 是 与 该 视图 平 级 的 视图 ， 也 可 以 是 该 视图 的 上 级 视图 (上 级 视图 即 相 
对 布局 自身 ) 。 有 了 参照 物 之 后 ， 还 得 指定 当前 视图 位 于 参照 物 的 哪个 方向 ,才能 确定 该 视图 的 具 
体位 置 。 

在 代码 中 指定 参照 物 及 其 所 处 方位 ， 调 用 的 是 布局 参数 对 象 的 addRule 方法 ， 方 法 格式 形 如 
“addRule( 方 位 类 型 ， 参 照 物 的 资源 ID)”。 下 面 是 一 个 给 相对 布局 添加 下 级 视图 的 Kotlin 代码 例子 : 

// 根 据 参照 物 与 方位 类 型 添加 下 级 视图 
Private fun addNewView(align: Int, referId: Int) { 
var Vv = View(this) 
V.setBackgroundColor (Color .GREEN) 
val rl_params = RelativeLayout.LayoutParams (100, 100) 
rl params.addRule (align, referId) 
VvV.layoutParams = rl params 
Vv.setOonLongClickListener { vv -> rl content.removeView (vv); true} 
rl_content .addView(v) 
} 

相对 布局 代码 里 的 方位 类 型 有 多 种 取 值 ， 比 如 RelativeLayout.LEFT_OF 表示 位 于 指定 视图 的 
左边 ，RelativeLayout.ALIGN_RIGHT 表示 与 指定 视图 右 侧 对 齐 ，RelativeLayout.CENTER_IN_ 
PARENT 表示 位 于 上 级 视图 中 央 等 。 举 个 例子 ， 要 让 某 视 图 位 于 指定 视图 上 方 ， 并 且 与 上 级 视图 
的 左 侧 对 齐 ， 则 调用 addRule 方法 的 Kotlin 代码 如 下 所 示 : 

rl params.addRule (RelativeLayout .ABOVE， 指 定 视 图 的 资源 ID) 
rl params.addRule (RelativeLayout.ALIGN_PARENT_LEFT， 上 级 视图 的 资源 ID) 

由 此 可 见 ， 常 规 的 addRule 调用 代码 有 点 元 长 ， 因 此 Kotlin 利用 Anko 库 将 相对 位 置 的 写法 进 
行 了 简化 , 具体 办 法 是 引入 扩展 函数 实现 相对 位 置 的 设 定 , 矢 如 above 方法 表示 当前 视图 位 于 指定 
视图 上 方 ， 而 alignParentLeft 方法 表示 当前 视图 与 上 级 视图 的 左 侧 对 齐 。 于 是 原来 指定 相对 位 置 的 
Kotlin 代码 简化 如 下 : 

rl_params .above (指定 视图 的 资源 ID) 
rl params.alignParentLeft () 

因为 这 几 个 新 方法 都 来 自 于 Anko 库 ， 所 以 要 在 代码 头 部 加 入 下 面 一 行 导入 语句 : 

import org.jetbrains.anko.* 


另外 ， 要 修改 模块 的 build.gradle， 在 dependencies 节点 中 补充 下 述 的 anko-common 包 编 译 配置 : 


compile "org.jetbrains.anko:anko-common:Sanko_Vversion" 


除了 above 和 alignParentLeft 之 外 ，Anko 还 提供 了 其 余 的 相对 位 置 设 定 方法 ， 它 们 与 原来 写 
法 的 对 应 关系 说 明 见 表 6-4。 
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表 6-4 相对 位 置 的 Anko 方法 与 RelativeLayout 类 的 对 应 关系 




















相对 位 置 说 明 Anko 库 的 相对 位 置 RelativeLayout 类 的 相对 位 置 
位 于 指定 视图 左边 leftOf LEFT_ OF 

与 指定 视图 头 部 对 齐 sameTop ALIGN_TOP 

位 于 指定 视图 上 方 Above ABOVE 

与 指定 视图 左 侧 对 齐 sameLeft ALIGN LEFT 

位 于 指定 视图 右边 rightOf RIGHT_OF 

与 指定 视图 底部 对 齐 sameBottom ALIGN_BOTTOM 





位 于 指定 视图 下 方 Below BELOW 
与 指定 视图 右 侧 对 齐 sameRight ALIGN RIGHT 


位 于 上 级 视图 中 央 CENTER _IN_PARENT 
与 上 级 视图 左 侧 对 齐 ALIGN PARENT LEFT 
位 于 上 级 视图 垂直 方向 的 中 部 centerVertically CENTER VERTICAL 
与 上 级 视图 项 部 对 齐 ALIGN PARENT TOP 
位 于 上 级 视图 水 平方 向 的 中 部 centerHorizontally CENTER_HORIZONTAL 
与 上 级 视图 右 侧 对 齐 alignParentRight ALIGN PARENT RIGHT 


图 底部 对 齐 alignParentBottom ALIGN_PARENT_BOTTOM 


6.2.3 ”约束 布局 ConstraintLayout 


























约束 布局 ConstraintLayout 是 Android Studio 2.2 开始 推出 的 新 布局 ， 并 从 Android Studio 2.3 
开始 成 为 默认 布局 文件 的 根 布局 ， 由 此 可 见 Android 官方 对 其 寄予 厚望 ,那么 约束 布局 究 况 具备 哪 
些 激动 人 心 的 特性 呢 ? 

传统 的 布局 如 线性 布局 LinearLayout、 相 对 布局 RelativeLayout 等 ， 若 要 描绘 不 规则 的 复杂 界 
面 , 往往 需要 进行 多 重 的 布局 嵌 套 , 不 但 僵硬 死板 、 缺 乏 灵活 性 , 并 且 嵌 套 过 多 拖 慢 页 面 演 染 速 度 。 
约束 布局 的 出 现 正 是 为 了 解决 这 些 问 题 ， 它 兼顾 灵活 性 和 高 效率 ， 可 以 看 作 是 相对 布局 的 升级 版 ， 
在 很 大 程度 上 改善 了 Android 的 用 户 体 验 。 开发 者 使 用 约束 布局 时 ， 有 多 种 手段 往 该 布局 内 添加 和 
拖 动 控件 , 既 能 像 原型 设计 软件 AxureRP 那样 在 画板 上 任意 拖 中 控件 ,也 能 像 传 统 布局 那样 在 XML 
文件 中 调整 控件 布局 , 还 能 在 代码 中 动态 修改 控件 对 象 的 位 置 状态 。 下 面 分 别 介绍 约束 布局 的 这 几 
种 使 用 方式 。 


1. 在 画板 上 拖 虫 控件 

设计 师 通 过 工具 软件 三 两 下 就 勾勒 出 界面 原型 ， 程 序 员 却 得 一 个 控件 一 个 控件 地 小 心 布局 ， 
并 对 控件 位 置 不 断 微调 以 符合 原型 上 的 尺寸 比例 。Android 原先 的 这 种 界面 手工 编码 方式 一 直 为 人 
所 诉 病 ， 因 为 “所 见 即 所 得 ” 才 是 界面 编码 的 理想 方式 ， 比 如 iOS 很 早 就 在 Xcode 中 集成 了 故事 
板 ， 使 得 iOS 程序 员 能 够 像 设 计 师 那样 在 画板 上 拖 动 控件 ， 从 而 加 快 了 界面 编码 的 工作 效率 。 所 
幸 自 从 约束 布局 ConstraintLayout 诞生 之 后 ，Android 程序 员 终 于 跟 上 时 代步 伐 ， 也 能 在 约束 布局 
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内 部 随意 拖 电 控 件 ,， 同 时 存在 主 从 关系 的 控件 之 间 ， 附 庸 控 件 会 跟随 目标 控件 一 起 移动 ， 从 而 省 却 
了 界面 微调 的 大 量 劳 动 。 

画板 上 的 约束 布局 控件 拖 动 效果 如 图 6-9 和 图 6-10 所 示 ， 其 中 图 6-9 所 示 为 拖 动 前 的 画板 界 
面 ， 图 6-10 所 示 为 拖 动 后 的 画板 界面 。 











图 6-9 拖 动 前 的 约束 布局 面板 图 6-10 拖 动 后 的 约束 布局 面板 





2. 在 XML 文件 中 调整 控件 布局 
传统 布局 如 线性 布局 、 相 对 布局 基本 是 在 XML 文件 中 手工 添加 控件 节点 , 约束 布局 
许 在 布局 文件 中 指定 控件 的 相对 位 置 , 这 跟 相 对 布局 内 部 的 控件 位 置 调整 类 似 , 只 不 过 用 来 表 
置 的 属性 换 了 个 名 字 罢 了 。 与 控制 方位 有 关 的 属性 说 明 如 下 所 示 : 
layout_constraintTop_toTopOf: 该 控件 的 顶部 与 另 一 个 控件 的 顶部 对 齐 。 
layout_constraintTop_toBottompOf: 该 控件 的 顶部 与 另 一 个 控件 的 底部 对 齐 。 
layout_constraintBottom_toTopOf : 该 控件 的 底部 与 另 一 个 控件 的 顶部 对 齐 。 
layout_constraintBottom_toBottomOf: 该 控件 的 底部 与 另 一 个 控件 的 底部 对 齐 。 
layout_constraintLeft_ toLeftOf : 该 控件 的 左 侧 与 另 一 个 控件 的 左 侧 对 齐 。 
layout_constraintLeft_ toRightOf : 该 控件 的 左 侧 与 另 一 个 控件 的 右 侧 对 齐 。 
layout_constraintRight toLeftOf : 该 控件 的 右 侧 与 另 一 个 控件 的 左 侧 对 齐 。 
layout_constraintRight_toRightOf : 该 控件 的 右 侧 与 另 一 个 控件 的 右 侧 对 齐 。 
下 面 是 一 个 运用 约束 布局 的 XML 文件 例子 : 
<android.support.constraint.ConstraintLayout xmlns:android= 
"http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/cl content" 
android:layout width="match parent" 






© 0 0 ee ee @ @ 


android:layout height="match parent"> 


<TextView 
android:id="@+id/tv first" 
android:layout width="wrap_content" 
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android:layout height="wrap content" 
app:layout_ constraintTop toTopOf="parent" 
android:layout marginTop="40dp" 

app:layout constraintLeft toLeftOf="parent" 
android:layout marginLeft="200dp" 
android:background="@color/blue" 
android:text=" 我 是 山大 王 " 
android:textSize="17sp" 
android:textColor="@color/black" /> 


<TextView 

android:id="@+id/tv_second" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout marginTop="40dp" 
app:layout constraintTop toBottomOf="@+id/tv first" 
android:layout marginLeft="20dp" 
app:layout_constraintLeft toLeftOf="@+id/tv first" 
android:background="@color/blue" 
android:text=" 我 是 巡 山 的 小 唆 哪 " 
android:textSize="17sp" 
android:textColor="@color/black" /> 

</android.support.constraint.ConstraintLayout> 


与 该 布局 文件 对 应 的 效果 界面 如 图 6-11 所 示 ， 可 见 第 二 
个 文本 视图 的 位 置 由 第 一 个 文本 视图 的 位 置 决定 。 


3. 在 代码 中 添加 控件 我 是 山大 王 

若 要 利用 代码 给 约束 布局 动态 添加 控件 ， 则 可 照常 调用 
addView 方法 。 不 同 之 处 在 于 ， 新 控件 的 布局 参数 必须 使 用 约 
束 布局 的 布局 参数 ， 即 ConstraintLayout.LayoutParams， 该 参数 ”图 6-11 在 XML 布局 中 添加 约束 布局 
通过 setMargins/setMarginStart/setMarginEnd 方法 设置 新 控件 与 周围 控件 的 间距 。 至 于 新 控件 与 周 
围 控 件 的 位 置 约束 关系 ， 则 参照 ConstraintLayout.LayoutParams 的 下 列 属性 说 明 。 


topToTop: 当前 控件 的 顶部 与 指定 ID 的 控件 顶部 对 齐 。 
topToBottom: 当前 控件 的 顶部 与 指定 ID 的 控件 底部 对 齐 。 
bottomToTop: 当前 控件 的 底部 与 指定 ID 的 控件 顶部 对 齐 。 
bottomToBottom: 当前 控件 的 底部 与 指定 ID 的 控件 底部 对 齐 。 
startToStart: 当前 控件 的 左 侧 与 指定 ID 的 控件 左 侧 对 齐 。 
startToEnd: 当前 控件 的 左 侧 与 指定 ID 的 控件 右 侧 对 齐 。 
endToStart: 当前 控件 的 右 侧 与 指定 ID 的 控件 左 侧 对 齐 。 
endToEnd: 当前 控件 的 右 侧 与 指定 ID 的 控件 右 侧 对 齐 。 


下 面 是 在 约束 布局 中 添加 新 控件 的 Kotlin 代码 例子 : 


simple 


我 是 巡 山 的 小 嗪 哆 | 


122 | Kotlin 从 零 到 精通 Android 开发 


Private fun addNewView() { 
val tv = TextView(this) 
tv.text = "长 按 删 除 该 文本 " 
val container = ConstraintLayout .LayoutParams ( 
ConstraintLayout .LayoutParams .WRAP_ CONTENT, 
ConstraintLayout .LayoutParams .WRAP CONTENT 


) 

// 设 置 控件 左 侧 与 男 一 个 控件 的 左 侧 对 齐 

// 水 平方 向 上 只 能 使 用 start 和 end， 因 为 left 和 right 可 能 无 法 奏效 

container.startToStart = lastViewId 

// 设 置 控件 顶部 与 男 一 个 控件 的 底部 对 齐 

container.topToBottom = lastViewId 

container.topMargin = dip(30) 

// 左 侧 间距 要 使 用 Start， 不 能 用 Left， 因 为 set .applyTo 方法 会 清空 Left 的 间距 。 
marginStart 需要 API17 支持 

container .marginStart = dip(10) 

tv.layoutParams = container 

tv.setOnLongClickListener { vv -> cl content.removeView(vv); true } 

lastViewId += 1000 

tv.id = lastViewId 

cl_content .addView (tv) 


添加 新 控件 的 效果 如 图 6-12 和 图 6-13 所 示 ， 其 中 图 6-12 所 示 为 添加 左边 的 第 一 个 文本 视图 
后 的 界面 ， 图 6-13 所 示 为 添加 左边 的 第 二 个 文本 视图 后 的 界面 。 





长 按 删除 该 文本 








我 是 山大 王 我 是 山大 王 
长 按 删除 该 文本 
我 是 巡 山 的 小 叶 吧 我 是 巡 山 的 小 叶 喝 
6-12 ”代码 添加 第 一 个 约束 关系 的 TextView 图 6-13 ”代码 添加 第 二 个 约束 关系 的 TextView 


4. 在 代码 中 动态 调整 控件 位 置 

有 时 根据 用 户 在 界面 上 的 操作 需要 立即 调整 相关 控件 的 显示 位 置 ， 这 要 在 代码 中 修改 控件 的 
位 置 参数 。 既 然 添 加 控件 时 可 以 通过 布局 参数 指定 控件 位 置 , 那么 调整 控件 位 置 一 样 也 可 以 通过 布 
局 参数 来 实现 ， 基 本 流程 依次 为 : 先 调用 getLayoutParams 方法 获得 当前 的 布局 参数 ， 再 指定 新 的 
控件 约束 关系 及 间距 ， 最 后 调用 setLayoutParams 启用 新 的 布局 参数 。 

可 是 按照 传统 的 布局 参数 方式 存在 诸多 不 便 之 处 ， 比 如 以 下 几 点 就 很 不 合理 : 

(1) 控件 约束 关系 的 目标 指定 与 间距 设 定 是 分 开 的 , 其 他 人 难以 找到 二 者 之 间 的 对 应 ”关系 。 

(2) setMargins 方法 同时 设置 上 下 左右 四 个 方向 的 间距 ， 无 法 单独 设置 某 个 方向 的 间距 。 

(3) 布局 参数 在 启用 时 立即 生效 ， 也 就 是 说 控件 位 置 一 瞬间 挪动 ， 没 有 渐变 的 过 程 ， 让 用 户 





第 6 章 Kotlin 使 用 简单 控件 | 123 


觉得 很 突 光 。 控 件 位 置 的 整个 移动 过 程 具 有 两 个 界面 ， 分 别 如 图 6-14 和 图 6-15 所 示 ， 其 中 图 6-14 
所 示 为 移动 之 前 的 界面 ， 图 6-15 所 示 为 移动 之 后 的 界面 。 








我 是 山大 王 我 是 山大 王 
我 是 巡 山 的 小 呈 喝 我 是 巡 山 的 小 叶 吧 
图 6-14 约束 控件 移动 之 前 的 界面 图 6-15 约束 控件 移动 之 后 的 界面 





为 了 改进 以 上 几 个 问题 ，constraint-layout 开发 包 从 1.0.1 本 版 开始 增加 了 新 的 约束 设置 类 
ConstraintSet， 该 工具 针对 这 几 个 问题 分 别 给 出 了 相应 的 解决 方案 : 


(1) 提供 connect 方 法 ， 一 次 性 指定 存在 约束 关系 的 两 个 控件 以 及 它们 的 间距 。 
(2) 提供 setMargin 方法 ， 通 过 指定 方向 参数 ， 从 而 允许 单独 设置 上 下 左右 某 个 方向 的 间距 。 
(3) 提供 渐变 管理 类 TransitionManager， 以 支持 展示 空间 位 置 变 化 的 切换 动画 。 


下 面 是 使 用 ConstraintSet 修改 控件 位 置 的 具体 Kotlin 代码 : 


Private fun moveView() { 

val margin = dip((if (isMoved) 200 else 20) .toFloat()) 

// 需 要 下 载 最 新 的 constraint-layout 才能 使 用 ConstraintSet 

val set = ConstraintSet() 

// 复 制 原 有 的 约束 关系 

set.clone(cl content) 

// 清 空 该 控件 的 约束 关系 

//set.clear (tv first.getId()); 

// 设 置 该 控件 的 约束 宽度 

//set.constrainwidth (tv_first.getId()，ConstraintLayout .LayoutParams . 
WRAP_CONTENT); 

// 设 置 该 控件 的 约束 高 度 

//set.constrainHeight (tv_first.getId(),ConstraintLayout .LayoutParams . 
WRAP_CONTENT); 

/7 设置 该 控件 的 项 部 约束 关系 与 间距 

//set.connect (tv first.getId(), ConstraintSet.TOP, cl content.getId(), 
ConstraintSet.BOTTOM, margin); 

// 设 置 该 控件 的 底部 约束 关系 与 间距 

//set.connect (tv first.getId(), ConstraintSet.BOTTOM, 
cl _ content.getId(), ConstraintSet.BOTTOM, margin); 

// 设 置 该 控件 的 左 侧 约束 关系 与 间距 

set.connect (tv first.id, ConstraintSet.START, cl content.id, 
ConstraintSet.START, margin) 

// 设 置 该 控件 的 右 侧 约束 关系 与 间距 
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//set.connect (tv first.getId(), ConstraintSet.END, cl content.getId(), 
ConstraintSet.END, margin); 
//LEFT 和 RIGHT 的 margin 不 管用 ， 只 有 START 和 END 的 margin 才 管用 
//set.setMargin(tv init.getId(), ConstraintSet.START, 200); 
// 启 用 新 的 约束 关系 
set .apPp1YyTo (cl1_content) 
isMoved = !isMoved 
为 了 能 够 显示 位 置 变 化 的 动画 ， 在 移动 控件 之 前 要 先 通过 管理 工具 TransitionManager 开启 渐 
变动 画 效果 。 设 定 动画 功能 的 Kotlin 代码 如 下 所 示 : 
btn move soft.setOnClickListener { 
// 使 用 动画 展示 新 旧 约 束 关系 的 切换 过 程 。 若 删 掉 这 行 , 则 不 展示 切换 动画 。 该 方法 需要 API19 
支持 


TransitionManager .beginDelayedTransition(cl1 content) 
moveView() 


} 
上 述 变 更 控件 位 置 代 码 的 对 应 效果 如 图 6-16 和 图 6-17 所 示 ， 其 中 图 6-16 展示 移动 开始 不 久 
的 界面 ， 图 6-17 展示 移动 将 要 结束 的 界面 ， 可 见 有 了 切换 动画 看 起 来 就 比较 柔和 了 。 


simple 


我 是 山大 王 


我 是 巡 山 的 小 唆 哆 





图 6-16 约束 布局 移动 动画 正在 开始 播放 图 6-17 约束 布局 移动 动画 即将 结束 播放 


6.3 ”使 用 图 文 控件 


手机 App 的 酷 炫 界 面 其 实 是 由 大 量 文本 和 图 片 以 及 各 种 特效 堆砌 出 来 的 ， 这 里 面 的 基础 控件 
无 非 就 是 文本 视图 与 图 像 视图 ， 前 者 专门 用 于 显示 文字 ， 而 后 者 专门 用 于 显示 图 片 ， 因 而 两 者 构成 
了 多 彩 界 面 的 基石 。 当 然 手机 作为 一 种 智能 终端 ， 需 要 方便 接收 用 户 的 输入 信息 ， 这 又 用 到 了 另 一 
种 基础 控件 一 一 文本 编辑 框 .编辑 框 与 文本 视图 、 图 像 视图 一 同 组 成 Android 三 种 常用 的 图 文 控件 ， 
接 下 来 就 对 这 三 种 图 文 控 件 分 别 进行 介绍 。 


6.3.1 文本 视图 TextView 


6.2.3 小 节 介绍 约束 布局 时 ， 通 过 动态 添加 文本 视图 演示 布局 效果 ， 当 时 只 用 到 了 text 属性 填写 
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文本 内 容 。 但 是 文本 视图 TextView 并 不 仅 限于 显示 简单 的 文本 ， 还 能 用 来 展示 某 些 特效 文字 效果 ， 
比如 常见 的 跑马 灯 动 画 。 当 一 行文 本 的 内 容 太 多 ， 导 致 无 法 全 部 显示 ， 但 也 不 想 分 行 展示 时 ， 只 能 
让 文字 从 左 向 右 滚动 显示 ， 类 似 于 跑马 灯 效 果 。 像 电视 在 播报 突 发 新 闻 时 ， 就 经 常 在 屏幕 下 方 轮 播 
消息 文字 ， 辟 如“ 快讯， 我国 选手 *** 在 刚刚 结束 的 ** 比 赛 中 为 中 国 代表 团 夺 得 第 ** 枚 金牌 ”等 。 

若 要 通过 代码 实现 跑马 灯 滚 动 文字 的 特效 ， 则 需 联 合 设置 文本 的 多 个 属性 值 ， 包 括 省 略 方式 
ellipsize 设 定 为 TextUtils.TruncateAtMARQUEE， 还 要 设 定单 行 显示 并 获得 焦点 等 。 实 现 跑马 灯 效 
果 的 Kotlin 代码 例子 如 下 所 示 : 


class TextMarqueeActivity : AppCompatActivity() { 
Private Var bPause = false 











override fun onCreate (savedInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 
setContentView(R.layout.activity text marquee) 
tv_marquee.text = "快讯 : 红色 预警 ， 超 强 台 风 “ 泰 利 ” 即 将 登陆 ， 请 居民 关 紧 门窗 、 
备 足 粮油 ， 做 好 防汛 救灾 准备 ! " 
tv marquee.textSize = 17f 
tv marquee.setTextColor (Color .BLACK) 
tv marquee.setBackgroundColor (Color .WHITE) 
tv_marquee.gravity = Gravity.LEFT or Gravity.CENTER // 左 对 齐 且 垂直 居中 
tv_marquee.ellipsize = TextUtils.TruncateAt .MARQUEE // 从 右 向 左 滚动 的 跑 
马 灯 
tv_marquee.setSingleLine (true) // 跑 马 灯 效 果 务必 设置 SingleLine 单行 显示 
tv_marquee.setOnClickListener { 
bPause = !bPause 
tvV_marquee.isFocusable = if (bPause) false else true 
tv_marquee.isFocusableInTouchMode = if (bPause) false else true 


} 


跑马 灯 滚动 的 效果 界面 如 图 6-18 和 图 6-19 所 示 ， 其 中 图 6-18 表示 跑马 灯 文 字 在 滚动 之 中 ， 
图 6-19 表示 跑马 灯 文 字 停止 滚动 。 








跑马 灯 效 果 ， 点 击 暂 停 ， 再 点 击 恢复 跑马 灯 效果 ， 点 击 暂停 ， 再 点 击 恢复 
R: 红色 预警 ， 超 强 台风 “泰利 ”即将 登陆 ， 请 ; 讯 : 红色 预警 ， 超 强 台风 “泰利 ”即将 登陆 … 
图 6-18 跑马 灯 文字 正在 滚动 图 6-19 跑马 灯 文 字 停止 滚动 





看 过 了 跑马 灯 的 效果 图 ， 再 回头 浏览 实现 该 功能 的 Kotlin 代码 ， 发 现 TextView 的 部 分 属性 允 
许 直接 赋值 ， 而 另 一 部 分 属性 仍 需 通过 方法 设置 。 这 些 属性 设置 的 Kotlin 和 Java 实现 方式 对 比 见 
表 6-5。 
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表 6-5 文本 视图 属性 设置 的 Kotlin 和 Java 实现 方式 对 比 
文本 视图 的 属性 设置 说 明 Kotlin 的 实现 方式 Java 的 实现 方式 
文本 内 容 text setText 
文本 大 小 textSize setTextSize 
文本 颜色 setTextColor setTextColor 
背景 颜色 setBackgroundColor setBackgroundColor 
对 齐 方 式 gravity setGravity 
多 余 文 本 的 省 略 方 式 ， 取 值 说 明 见 表 6-6 ellipsize setEllipsize 
是 否 单行 显示 setSingleLine setSingleLine 
是 否 获 得 焦点 isFocusable setFocusable 
是 否 在 触摸 时 获得 焦点 isFocusableInTouchMode setFocusableInTouchMode 
表 6-6 多 余 文 本 的 省 略 方式 
TruncateAt 类 的 省 略 方式 说 明 
TruncateAt.START 省 略 号 在 开头 


TruncateAt.MIDDLE 
TruncateAt.END 
TruncateAt.MARQUEE 





省 略 号 在 中 间 
省 略 号 在 末尾 
跑马 灯 显 示 








除了 以 上 的 属性 设置 方式 产生 变动 外 ， 另 外 注意 到 文本 对 齐 方 式 的 赋值 情况 也 有 变化 ， 原 来 
Java 设置 文本 对 齐 方 式 的 代码 是 下 面 这 样 的 : 
tv marquee.setGravity (Gravity.LEFT | Gravity.CENTER); 
然而 Kotlin 对 应 的 对 齐 设置 代码 却 是 以 下 格式 : 
tv marquee.gravity = Gravity.LEFT or Gravity.CENTER 
由 此 可 见 ， 对 齐 方 式 的 或 操作 外 在 Java 中 采取 竖 线 “|” 表 示 , 但 在 Kotlin 中 采取 关键 字 “or” 
表示 。 不 只 是 这 个 或 运算 ， 所 有 的 位 运算 都 被 Kotlin 定义 了 新 的 关键 字 ， 表 6-7 列举 了 常用 的 几 种 
位 运算 符 在 Kotlin 和 Java 中 的 展现 形式 。 























表 6-7 ”位 运算 符 在 Kotlin 和 Java 中 的 展现 形式 对 比 
位 运算 说 明 Kotlin 的 位 运算 符 Java 的 位 运算 符 
按 位 与 and & 
按 位 或 or | 
按 位 异 或 | xor ^ 
按 位 左 移 [sm < 
按 位 右 移 | shr > 
无 符号 右 移 ， 高 位 补 0 ushr >>> 
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6.3.2 图像 视图 ImageView 


图 像 视图 是 另 一 种 常用 的 基本 控件 ， 在 基本 的 图 文 控件 之 中 ，TextView 用 于 显示 文本 内 容 ， 
而 ImageView 用 于 显示 图 像 信 息 。 

图 像 视图 ImageView 在 代码 中 调用 的 方法 说 明 如 下 。 
setImageDrawable: 设置 图 形 的 Drawable 对 象 。 
setImageResource: 设置 图 形 的 资源 ID。 
setImageBitmap: 设置 图 形 的 位 图 对 象 。 
setScaleType: 设置 图 形 的 拉 伸 类 型 ， 在 Kotlin 中 可 直接 给 属性 scaleType 赋值 。 拉 伸 类 型 的 
取 值 说 明 见 表 6-8。 


表 6-8 拉 伸 类 型 的 取 值 说 明 
ScaleType 类 的 拉 伸 类 型 说 明 


ScaleType.FIT XY 拉 伸 图 片 使 之 正好 填 满 视 图 (图 片 可 能 被 拉 伸 变形 ) 
ScaleType.FIT_START 拉 伸 图 片 使 之 位 于 视图 上 部 
ScaleType.FIT_CENTER 拉 伸 图 片 使 之 位 于 视图 中 间 

ScaleTypeFIT_END 拉 伸 图 片 使 之 位 于 视图 下 部 

ScaleType.CENTER 保持 图 片 原 尺 寸 ， 并 使 之 位 于 视图 中 间 


ScaleType.CENTER_CROP 拉 伸 图 片 使 之 充满 视图 ， 并 位 于 视图 中 间 
使 图 片 位 于 视图 中 间 (只 压 不 拉 )。 当 图 片 尺寸 大 于 视图 时 ，centerInside 等 


SealeType.CENTER_INSIDE 。 | 司 于 fitCenter， 当 图 片 尺寸 小 于 视图 时 ，centerinside 等 同 于 center 


读者 应 该 注意 到 了 ，ImageView 的 拉 伸 类 型 种 类 繁多 ， 且 文字 说 明 不 易 理 解 ， 特 别 是 与 center 
相关 的 类 型 就 有 4 种 : fitCenter、center、centerCrop、centerInside， 真 是 要 把 人 搞 早 了。 接 下 来 还 
是 进行 实验 ,把 一 张 图 片 放 入 图 像 视图 ， 然 后 尝试 运用 不 同 的 拉 伸 类 型 ， 看 看 它们 之 间 究 竟 有 什么 
区 别 。 下 面 是 图 片 拉 伸 演 示 用 到 的 Kotlin 代码 例子 : 

class ImageScaleActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 

super.onCreate (savedInstanceState) 

setContentView(R.layout .activity image scale) 

iv_scale.setImageResource (R.drawable.apPlel) 

btn center.setOnClickListener { iv scale.scaleType = ScaleType .CENTER } 

btn fitCenter.setOnClickListener { iv_ scale.scaleType = 
ScaleType.FIT CENTER } 

btn centerCrop.setOnClickListener { iv scale.scaleType = 
ScaleType.CENTER CROP } 

btn_centerInside.setOnClickListener { iv_ scale.scaleType = 
ScaleType.CENTER_ INSIDE } 
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btn fitXY.setOnClickListener { iv scale.scaleTYyYPe = ScaleType.FIT XY } 
btn_fitStart.setOnClickListener { iv scale.scaleType = 
ScaleType.FIT START } 
btn fitEnd.setOnClickListener { iv scale.scaleType = 
ScaleType.FIT END } 
} 
} 


运行 上 述 演 示 代 码 ， 可 见 图 像 拉 伸 的 效果 如 图 6-20 一 图 6-23 所 示 。 其 中 图 6-20 展示 fitCenter 
效果 ， 此 时 图 片 被 拉 伸 但 未 超出 控件 范围 ， 图 6-21 展示 center 效果 ， 此 时 图 片 没 有 拉 仲 ， 图 6-22 
展示 centerCrop 效果 ， 此 时 图 片 被 拉 伸 且 已 超出 控件 范围 ， 图 6-23 展示 centerInside 效果 ， 此 时 图 
片 没有 拉 伸 。 


图 6-20 图 片 的 fitCenter 拉 伸 效果 图 6-21 图 片 的 center 拉 伸 效 果 


图 6-22 ”图片 的 centerCrop 拉 伸 效果 图 6-23 图 片 的 centerInside 拉 伸 效果 











6.3.3 文本 编辑 框 EditText 


前 面 介绍 的 文本 视图 只 能 显示 事先 设 定好 的 文本 ， 也 就 是 说 ，TextView 能 够 输出 文本 但 不 能 
输入 文本 。 要 想 监听 用 户 输入 的 文本 ， 就 要 用 到 文本 编辑 框 EditText， 用 户 可 在 编辑 框 里 面 输入 包 
括 文字 、 数 字 、 标 点 在 内 的 文本 信息 。 

为 了 规范 用 户 的 输入 信息 ，EditText 提供 了 setInputType 方法 ， 用 于 过 滤 合 法 的 输入 字符 ， 只 
有 符合 输入 类 型 的 字符 ， 才 允许 接收 并 显示 出 来 。Kotlin 可 直接 给 inputType 属性 设置 输入 类 型 ， 
从 而 取代 setInputType 的 方法 调用 ， 常 见 的 输入 类 型 取 值 说 明 见 表 6-9。 
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表 6-9 常见 输入 类 型 的 取 值 说 明 
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InputType 类 的 输入 类 型 说 明 
InputType.TYPE_CLASS TEXT 所 有 文本 
InputType.TYPE_CLASS NUMBER 只 能 是 数字 
InputType.TYPE_CLASS DATETIME 只 能 是 日 期 时 间 
InputType.TYPE_TEXT_VARIATION NORMAL 正常 显示 
InputType.TYPE_TEXT_VARIATION PASSWORD 密 文 显示 
InputType.TYPE_TEXT_ VARIATION _VISIBLE PASSWORD 明文 密码 


可 是 输入 类 型 仅仅 检验 字符 的 有 效 性 ， 尚 缺少 更 灵活 的 加 工 处 理 。 ti 
号 码 的 时 候 ， 能 否 在 输 完 11 位 数字 后 自动 触发 某 项 动作 ? 又 比如 有 时 希望 输入 的 文本 不 包 


符 和 换行 符 , 能 否 自动 屏 项 用 户 不 小 心 输 入 的 回 车 和 换行 符 ? 为 了 解决 以 上 问题 
一 个 编辑 观察 器 EditWatcher， 它 可 以 实时 监控 用 户 的 输入 字符 ， 并 且 支 持 在 输入 每 个 


发 者 进行 手工 干预 ， 从 而 实现 随时 校 验 、 随 时 加 工 的 功能 。 
下 面 是 演示 编辑 观察 器 处 理 的 Kotlin 代码 例子 : 


class EditTextActivity : APPCompatRctivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 


super.onCreate (savedInstanceState) 


setContentView(R.layout.activity edit text) 


/ /注意 不 能 直接 给 EdiText 控件 的 text 属性 赋值 
/ /否则 会 报错 Editable 与 String 类 型 不 匹配 
// 只 能 调用 setText 方法 对 EdiText 控件 设置 文本 
et phone.setText (""); 

// 显 示 明 文 数字 


et_phone.inputType = InputType.TYPE CLASS_ NUMBER 


// 显 示 明 文 密码 





含 EE 





车 





，EditText 四 置 了 
字符 时 由 开 





et phone.inputType = InputType.TYPE TEXT _ VARIATION _ VISIBLE PASSWORD 


// 隐 藏 密码 

et phone.inputType 
InputType.TYPE TEXT VARIATION PASSWORD 

// 给 编辑 框 添加 文本 变化 的 监听 器 


InputType.TYPE CLASS TEXT or 


et_ phone.addTextChangedListener (EditWatcher () ) 


} 


Private inner class EditWatcher : TextWatcher { 


override fun beforeTextChanged(s: CharSequence, start: Int, count: 


after: Int) {} 


override fun onTextChanged(s: CharSequence, start: Int, before: 


oounts TIE) {3 


override fun afterTextChanged(s: Editable) 


{ 


Int, 


Int, 
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var str = s.toString() 

// 发 现 输 入 回 车 符 或 换行 符 

if (str.indexOf("\r") >= 0 || str.indexOof("\n") >= 0) { 
// 去 掉 回 车 符 和 换行 符 
str = str.replace("\r", "").replace("\n", "") 

} 

if (str.length >= 11) { 
tv_phone.text = "您 输入 的 手机 号 码 是 : $str" 

} 


} 


编辑 观察 器 TextWatcher 的 运行 结果 如 图 6-24 和 图 6-25 所 示 ， 其 中 图 6-24 所 示 为 输入 10 位 
手机 号 码 时 的 界面 ， 图 6-25 所 示 为 输入 第 11 位 手机 号 码 时 的 界面 ， 可 见 输 满 11 位 手机 号 就 会 触 
发 输入 完成 动作 。 


simple Simple 








[1s960238696 
您 输入 的 手机 号 码 是 :15960238696 











图 6-24 输入 10 位 手机 号 码 时 的 界面 图 6-25 输入 11 位 手机 号 码 时 的 界面 
6.4 Activity 活动 跳 转 


活动 Activity 是 Android 最 常用 的 组 件 ， 一 般 来 说 ， 一 个 Activity 就 代表 一 个 页 面 ， 所 以 活动 
的 用 法 就 围绕 着 页 面 的 运行 过 程 而 展开 , 包括 活动 的 生命 周期 、 活 动 是 如 何 启动 的 、 活 动 页 面 之 间 
是 如 何 传递 信息 的 〈 包 括 发 送 数据 和 返回 数据 ) ， 等 等 。 本 节 就 对 各 种 Activity 用 法 对 应 的 Kotlin 
实现 方式 进行 逐步 的 阐述 。 





6.4.1 传送 配对 字段 数据 


Activity 的 活动 页 面 跳 转 是 App 常用 的 功能 之 一 ， 在 前 儿童 的 DEMO 源码 中 便 多 次 见 到 ， 常 
常 是 点 击 界面 上 的 某 个 按钮 ， 然 后 跳 转 到 与 之 对 应 的 下 一 个 页 面 。 对 于 App 开发 者 来 说 ， 该 功能 
的 实现 非常 普通 ， 使 用 Java 编码 不 过 以 下 两 行 代码 而 已 : 
Intent intent = new Intent (MainActivity.this, LinearLayoutActivity.class); 
startActivity (intent); 


上 面 代码 的 关键 之 处 在 于 Intent 的 构造 函数 , 其 中 第 一 个 参数 指定 了 页 面 跳 转动 作 的 来 源 ， 即 
MainActivity 这 个 源 页 面 ，MainActivity.this 通常 简写 为 this; 构造 Intent 的 第 二 个 参数 则 表示 页 面 
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跳 转动 作 的 目的 地 ， 即 LinearLayoutActivity 这 个 目标 页 面 。 倘 若 把 这 两 行 Java 代码 转换 为 Kotlin 
代码 〈 复 制 这 两 行 然 后 粘贴 到 kt 文件 中 ，Android Studio 就 会 自动 完成 转换 ) ， 则 可 看 到 活动 跳 转 
的 Kotlin 代码 如 下 所 示 : 
val intent = Intent (this@MainActivity, LinearLayoutActivity::class.java) 
startActivity (intent) 


对 比 之 下 ， 这 里 的 Kotlin 代码 与 Java 代码 主要 有 两 点 不 同 之 处 : 


(1) 在 类 内 部 指 代 自 身 的 this 关键 字 ，Java 的 完整 写法 是 “类 名 .this”， 而 Kotlin 的 完整 写 
法 是 “this@ 类 名 ”， 当 然 二 者 均 可 简写 为 “this”。 

(2) 获 取 某 个 类 的 class 对 象 , Java 的 写法 是 “类 名 .class ”, 而 Kotlin 的 写法 是 “类 名 ::classjava”， 
一 看 便 知 带 有 浓 浓 的 Java 风味 。 


看 起 来 ，Kotlin 代码 与 Java 代码 半斤八两 ， 未 有 明显 的 简化 ， 令 人 产生 小 小 的 失望 。 但 细心 
的 读者 也 许 已 经 注意 到 了 ， 前 几 章 附录 源码 里 的 活动 跳 转 并 非 上 述 的 Kotlin 正宗 写法 ， 而 是 下 面 
这 种 简化 版 的 写法 : 


startActivity<LinearLayoutActivity>() 


究 其 原因 ， 乃 是 Anko 库 利用 Kotlin 的 扩展 函数 给 Context 类 新 增 了 名 为 startActivity 的 新 方 
法 。 故 而 使 用 简化 版 的 写法 之 前 ， 必 须 先 导入 Anko 库 的 指定 代码 ， 即 在 kt 文件 头 部 添加 下 面 一 行 
导入 语句 : 
import org.jetbrains.anko.startActivity 
另外 ， 要 修改 模块 的 build.gradle， 在 dependencies 节点 中 补充 下 述 的 anko-common 包 编 译 配置 : 
compile "org.jetbrains.anko:anko-common: $anko version" 


活动 页 面 跳 转 的 时 候 ， 往 往 还 要 携带 一 些 请 求 参数 ， 如 果 使 用 Java 编码 ， 可 以 很 轻松 地 调用 
Intent 对 象 的 putExtra 方法 ， 通 过 “putExtra( 参 数 名 , 参数 值 )” 的 方式 传递 消息 ， 就 像 下 面 的 代码 
那样 : 


Intent intent = new Intent (this, ActSecondActivity.class); 

intent .putExtra("request time", DateUtil.getNowTime()); 
intent.putExtra("request content", et_ request.getText().toString()); 
startActivity (intent); 


如 果 使 用 Anko 的 简化 写法 ， 其 实 也 很 容易 ， 只 要 在 startActivity 后 面 的 括号 中 依次 填 上 每 个 
参数 字段 的 字段 名 和 字段 值 ， 传 送 跳 转 参 数 的 具体 Kotlin 代码 如 下 所 示 : 
// 第 一 种 写法 ， 参 数 名 和 参数 值 使 用 关键 字 to 隔 开 
startActivity<ActSecondActivity>( 
"request time" to DateUtil.nowTime, 
"request content" to et request.text.toString()) 


注意 到 上 面 的 写法 使 用 关键 字 to 隔 开 参数 名 和 参数 值 ， 感 觉 不 够 美观 ， 而 且 容易 使 人 迷惑 ， 
to 后 面 究竟 要 跟着 字段 名 还 是 字段 值 呢 ? 所 以 Anko 库 提供 了 另 一 种 符合 习惯 的 写法 , 也 就 是 利用 
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Pair 类 把 参数 名 和 参数 值 进行 配对 ，Pair 的 第 一 个 参数 为 字段 名 ， 第 二 个 参数 为 字段 值 。 据 此 改写 
后 的 Kotlin 跳 转 代码 如 下 所 示 : 
// 第 二 种 写法 ， 利 用 Pair 把 参数 名 和 参数 值 进行 配对 


startActivity<ActSecondActivity>( 
Pair("request time", DateUtil.nowTime), 
Pair("request content", et request.text.toString())) 


无 论 哪 种 写法 ， 在 下 一 个 活动 中 解析 请 求 参数 的 方式 都 一 样 ， 都 得 先 获取 Bundle 对 象 ， 然 后 
分 别 根据 字段 名 称 获 取 对 应 的 字段 值 。 解 析 请 求 参 数 的 具体 Kotlin 代码 如 下 所 示 : 


class ActSecondActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity act_ second) 
// 获 得 请 求 参 数 的 包 囊 
val bundle = intent.extras 
val request time = bundle.getString("request time") 
val request content = bundle.getString("request content") 
tv_response.text = " 收 到 请 求 消息 : \n 请 求 时 间 为 ${request time}\n 请 求 内 容 为 

${request_content}" 
} 
} 


下 面 通过 测试 界面 观察 一 下 消息 数据 发 送 之 前 和 发 送 之 后 的 效果 ， 如 图 6-26 所 示 ， 这 时 第 一 
个 界面 准备 跳 转 到 第 二 个 界面 ; 如 图 6-27 所 示 ， 这 是 跳 转 后 的 第 二 个 界面 ， 此 时 界面 上 展示 第 一 
个 界面 传递 过 来 的 参数 信息 。 








本 收 到 请 求 消息 ; 
你 吃饭 了 吗 ? 请 求 时 间 为 09:24:01 


请 求 内 容 为 你 吃饭 了 吗 ? 
传送 请 求 参数 





图 6-26 第 一 个 界面 准备 跳 转 图 6-27 第 二 个 界面 接收 请 求 


6.4.2 ”传送 序列 化 数据 


Activity 之 间 传 递 的 参数 类 型 除了 整 型 、 浮 点 型 、 字 符 串 等 基本 数据 类 型 外 ， 还 允许 传递 序列 
化 结构 ， 如 Parcelable 对 象 。 这 个 Parcelable 对 象 可 不 是 简单 的 实体 类 ， 而 是 实现 了 Parcelable 接口 
的 实体 类 , 实现 接口 意味 着 该 类 必须 重 写 接口 定义 的 所 有 方法 , 无 论 你 愿 不 愿意 都 得 老 老 实 实地 依 
样 画 葫芦 。 辟 如 ,前面 的 活动 跳 转 传递 了 两 个 字段 数据 , 如 果 把 这 两 个 字段 放 到 Parcelable 对 象 中 ， 
仅仅 包含 两 个 字段 的 Parcelable 类 对 应 的 Java 代码 也 如 下 面 这 般 宛 长 : 
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public class MessageInfo implements Parcelable { 
Public String content; 
Public String send time; 


// 写 数据 

@Override 

Public void writeToParcel (Parcel out, int flags) { 
out .writeString (content); 
out .writeString(send time) 


// 例行公事 实现 createFromParcel 和 newArray 


Public static final Parcelable.Creator<MessageInfo> CREATOR 


= new Parcelable.Creator<MessageInfo>() { 

// 读数 据 

Public MessageInfo createFromParcel (Parcel in) { 
MessageInfo info = new MessageInfo(); 
info.content = in.readstring(); 
info.send time = in.readstring(); 
return info; 


} 


Public MessageInfo[] newRrray(int size) { 
return new MessageInfo[size]; 


】} 


@Override 
Public int describeContents() { 
return 0; 


} 
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看 看 这 架势 ， 如 此 简单 的 自 定义 Parcelable 序列 化 结构 类 ， 就 得 重 写 包 括 writeToParcel、 
createFromParcel、newArray、describeContents 在 内 的 4 个 方法 ， 可 谓 是 兴 师 动 众 。 由 此 可 见 ， 这 
里 又 是 Java 的 一 个 痛 点 , 正 适合 Kotlin 施展 拳脚 、 好 好 改进 。 在 第 5 章 的 类 和 对 象 中 介绍 了 Kotlin 
对 数据 类 的 写法 , 只 要 在 类 名 前 面 加 入 关键 字 data, Kotlin 即 可 自动 提供 get/set、equals、copy、toString 
等 诸多 方法 。 那 么 序列 化 对 象 的 改造 也 相当 简单 ， 仅 需 在 类 名 之 前 增加 一 行 注解 “@Parcelize” 就 


好 了 ， 于 是 整个 类 的 Kotlin 代码 只 有 下 面 究 究 几 行 : 
//eParcelize 注解 表示 自动 实现 Parcelable 接口 的 相关 方法 


@Parcelize 





data class MessageInfo (val content: String, val send time: String) 


Parcelable { 
外 
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不 过 若 想 正常 编译 ， 还 需 修 改 模块 的 编译 文件 build.gradle， 在 文件 末尾 添加 下 面 几 行 ， 表 示 
增加 对 安 卓 插件 的 编译 支持 : 
//epParcelize 标记 需要 设置 experimental = true 
androidExtensions { 
experimental = true 
} 


编译 文件 修改 完毕 ， 现 在 能 在 Kotlin 中 使 用 序列 化 对 象 的 注解 了 。 虽 然 自 定 义 的 MessageInfo 
类 内 部 没有 任何 一 行 代码 ， 但 是 它 除 了 有 具备 数据 类 的 所 有 方法 外 ， 也 自动 实现 了 Parcelable 接口 的 
几 个 方法 。 接 下 来 就 可 以 利用 该 类 传输 活动 跳 转 的 序列 化 数据 了 ， 下 面 是 改写 后 的 Kotlin 跳 转 
代码 : 
Val request = MessageInfol(et request.text.toString(), DateUtil.nowTime) 
startActivity<ParcelableSecondActivity>("message" to request) 


跳 转 后 的 下 一 个 页 面 调用 getParcelable 即 可 正常 获得 原始 的 序列 化 数据 ， 具 体 的 数据 解析 
Kotlin 代码 如 下 所 示 : 


class ParcelableSecondActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout .activity parcelable second) 
// 获 得 Parcelable 格式 的 请 求 参数 
val request = intent.extras.getParcelable<MessageInfo> ("message") 
tv_response.text = " 收 到 打包 好 的 请 求 消息 : \n 请 求 时 间 为 

${request.send time}\n 请 求 内 容 为 S{request.contentj}" 
} 
} 


同样 通过 测试 界面 观察 序列 化 对 象 的 打包 和 解 包 效果 ， 如 图 6-28 所 示 ， 这 时 第 一 个 页 面 准备 
携带 序列 化 数据 跳 转 到 第 二 个 页 面 ， 如 图 6-29 所 示 ， 这 是 跳 转 后 的 第 二 个 页 面 ， 此 时 界面 上 展示 
第 一 个 页 面 传递 过 来 的 序列 化 数据 。 











区 吗 ? 收 到 打包 好 的 请 求 消息 : 











请 求 时 间 为 09:24:37 
请 求 内 容 为 你 吃饭 了 吗 ? 
传送 打包 好 的 请 求 参数 
6-28 第 一 个 页 面 传送 序列 化 数据 图 6-29 第 二 个 页 面 接收 序列 化 数据 


6.4.3” 跳 转 时 指定 启动 模式 


前 面 提 到 Anko 库 的 startActivity 方法 取消 了 Intent 意图 对 象 ,这 个 做 法 有 利 有 次, 次 端 是 Intent 
对 象 还 有 其 他 的 设置 方法 ， 比 如 setAction 方法 用 来 设置 动作 、setData 方法 用 来 设置 路 径 、 
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addCategory 方法 用 来 设 设置 动作 类 别 、setType 方法 用 来 设置 数据 类 型 、setFlags 方法 用 来 设置 启动 
模式 等 。 所 以 对 于 复杂 一 点 的 活动 跳 转 , 必须 要 保留 Intent 对 象 , 为 此 Anko 库 额 外 提供 了 intentFor 
方法 ， 用 于 简单 生成 Intent Nog 其 书写 格式 类 似 于 startActivity 方法 ， 举 个 例子 : 


val intent = intentFor<ActSecondActivity>( 





"request time" to DateUtil.nowTime, 
"request content" to et request.text.toString()) 


这 下 通过 intentFor 方法 得 到 了 Intent 对 象 ， 再 去 设置 其 他 参数 就 方便 了 ， 活 动 跳 转 时 也 只 需 
调用 “startActivity(intent)” 即 可 。 

intentFor 方法 的 作用 并 不 仅 限于 得 到 一 个 意图 对 象 ， 还 可 以 用 来 设置 新 活动 的 启动 模式 。 启 
动 模式 是 Android 用 来 控制 Activity 活动 栈 行为 的 一 种 标志 ,在 App 运行 期 间 , 打开 的 页 面 会 被 逐 
个 加 入 一 个 活动 栈 。 一 般 来 说 ， 位 于 栈 项 的 是 App 首页 ， 其 后 打开 的 页 面 依次 加 到 栈 尾 ， 返 回 时 
从 栈 尾 依次 出 栈 。 但 是 出 于 效率 考虑 ， 有 时 我 们 希望 对 栈 的 操作 能 够 不 按 顺序 处 理 ， 所 以 也 就 有 了 
活动 页 面 的 启动 模式 。 

Android 有 两 种 方式 用 来 设置 Activity 的 启动 模式 ， 其 一 是 修改 AndroidManifest.xml， 在 指定 
的 activity 节点 添加 属性 launchMode， 表 示 本 活动 以 该 启动 模式 来 运行 ， 其 二 是 在 代码 中 给 Intent 
对 象 调用 setFlags 方法 ， 从 而 表明 接 下 来 打开 的 页 面 运用 该 启动 标志 。 下 面 分 别 详细 说 明 启 动 模式 
的 两 种 设置 方法 。 


1. 在 配置 文件 中 指定 启动 模式 
第 一 种 设置 办 法 是 在 AndroidManifest.xml 里 的 activity 节点 添加 属性 launchMode， 上 有 具体 的 
activity 节点 配置 内 容 示 例如 下 : 


<activity android:name=".ActSecondActivity" android:launchMode= 
"standard" /> 


其 中 ，launchMode 属性 的 几 种 取 值 说 明 见 表 6-10。 
表 6-10 launchMode 属性 的 取 值 说 明 














launchMode 属性 值 





标准 模式 ， 无 论 何 时 启动 哪个 activity， 都 是 重新 创建 该 页 面 的 实例 并 放 入 栈 尾 。 如 果 











不 指定 launchMode 属性 ， 就 默认 为 标准 模式 

singleTop | 启动 activity 时 ， 判 断 栈 项 正好 是 该 Activity 的 实例 ， 就 重用 该 实例 ， 否 则 创建 新 的 实 
例 并 放 入 栈 顶 ， 否 则 的 情况 与 tandard 类 似 

ii | 启动 activity 时 ， 判断 栈 中 存在 访 Aetivity 的 实例 ， 就 重用 该 实例 ， 并 清除 位 于 该 他 
上 面 的 所 有 实例 ， 否 则 的 情况 处 理 同 standard 

i 启动 activity 时 ， 将 该 Activity 的 实例 放 入 一 个 新 栈 中 ， 原 栈 的 实例 列表 保持 不 变 





2. 在 代码 里 面 设置 启动 标志 
第 二 种 设置 办 法 是 在 代码 中 给 Intent 对 象 调用 setFlags 方 法 ,具体 的 方法 调用 代码 如 下 ”所 示 : 


intent.setFlags (Intent .FLAG ACTIVITY NEW TASK); 
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之 所 以 要 在 代码 中 动态 指定 活动 页 面 的 启动 模式 ， 是 因为 AndroidManifestxml 中 对 每 个 
Activity 只 能 指定 唯一 的 启动 模式 。 如 果 想 在 不 同时 候 对 同一 个 Activity 运用 不 同 的 启动 模式 ， 显 
然 固定 的 launchMode 属性 无 法 满足 这 个 要 求 。 于 是 Android 允许 在 代码 中 手动 设置 启动 标志 ， 这 
样 在 不 同时 候 调 用 startActivity 方法 就 能 运行 特定 的 启动 模式 。 

适用 于 setFlags 方法 的 几 种 启动 标志 的 取 值 说 明 见 表 6-11。 

表 6-11 代码 中 的 启动 标志 取 值 说 明 
说 明 
开启 一 个 新 任务 ，flags 默认 该 值 。 该 值 类 似 于 launchMode= 


"standard" ， 不 同 之 处 在 于 ， 如 果 原 来 不 存在 活动 栈 ，FLAG 
ACTIVITY_ NEW_TASK 就 会 创建 一 个 新 栈 


当 栈 项 为 待 跳 转 的 activity 实例 时 ， 重 用 栈 项 的 实例 。 该 值 等 同 于 
launchMode="singleTop" 

当 栈 中 存在 待 跳 转 的 activity 实例 时 , 重新 创建 一 个 新 实例 , 并 将 原 
实例 上 方 的 所 有 实例 加 以 清除 。 该 值 与 launchMode="singleTask" 类 
似 ， 但 launchMode="singleTask" 采 用 onNewIntent 启用 原 任务 ， 而 
FLAG_ACTIVITY_CLEAR_TOP 采用 先 onDestroy 再 onCreate 创建 
新 任务 

该 标志 与 launchMode="standard" 情 况 类 似 ， 但 栈 中 不 保存 新 启动 的 
activity 实例 。 这 样 下 次 无 论 以 何 种 方式 再 启动 该 实例 ， 也 要 走 
standard 的 完整 流程 

该 标志 非常 暴力 ， 跳 转 到 新 页 面 时 ， 栈 中 的 原 有 实例 都 被 清空 。 注 
意 ， 该 标志 需要 结合 FLAG_ACTIVITY NEW_TASK 使 用 ， 即 
setFlags 的 参数 为 “IntentFLAG ACTIVITY CLEAR_TASKI 
Intent FLAG ACTIVITY NEW_TASK” 











Intent 类 的 启动 标志 





Intent.FLAG _ ACTIVITY NEW_TASK 





Intent FLAG_ACTIVITY_SINGLE_TOP 





IntentFLAG_ACTIVITY_CLEAR_TOP 





Intent. FLAG_ACTIVITY_NO_HISTORY 





Intent.FLAG ACTIVITY_ CLEAR TASK 





讲 了 这 么 多 的 启动 模式 , 可见 其 概念 很 是 琐碎 , 并 且 设 置 启动 标志 的 代码 也 较 曼 嗪 ,所 以 Kotlin 
利用 Anko 库 扩展 出 来 的 intentFor 函数 简化 启动 标志 的 设置 方式 。 例 如 ， 启 动 标志 
FLAG_ACTIVITY NEW_TASK 对 应 的 Anko 写法 ,连同 页 面 跳 转动 作 也 只 需 下 面 短 短 的 一 行 Kotlin 
代码 : 

startActivity(intent.newTask()) 

优化 后 的 启动 标志 设置 函数 newTask 延续 了 Kotlin 一 贯 的 简洁 风格 ， 至 于 其 他 的 启动 标志 ， 
则 可 将 “newTask” 替 换 为 对 应 的 设置 方法 。Java 的 启动 标志 与 Anko 的 标志 设置 函数 对 应 关系 见 
表 6-12。 

表 6-12 启动 标志 的 Anko 方法 与 Java 的 对 应 关系 
Intent 类 的 启动 标志 Anko 库 的 标志 设置 函数 
Intent.FLAG ACTIVITY NEW_TASK newTask() 








Intent. FLAG ACTIVITY_SINGLE_ TOP singleTop0 
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( 续 表 ) 
Intent 类 的 启动 标志 Anko 库 的 标志 设置 函数 
Intent.FLAG ACTIVITY CLEAR_TOP clearTop0 
IntentFLAG _ ACTIVITY NO_HISTORY noHistory() 
Intent.FLAG ACTIVITY CLEAR TASK clearTask() 





6.4.4 ”处 理 返 回 数据 


页 面 跳 转 的 多 数 情况 是 上 一 个 页 面 传递 请 求 参数 给 下 一 个 页 面 ， 当 然 也 有 少数 情况 是 上 一 
页 面 需 要 接收 下 一 个 页 面 的 返回 数据 。 此 时 Kotlin 跟 Java 一 样 都 采取 startActivityForResult 方 法 , 表 
示 这 次 活动 跳 转 要 求 处 理 返 回信 息 ， 具 体 的 Kotlin 代码 举例 如 下 : 
val info = MessageInfol(et request.text.toString(), DateUtil.nowTime) 
//ForResult 表示 需要 返回 参数 
startActivityForResult<ActResponseActivity>(0, "message" to info) 
那么 下 一 个 页 面 返回 应 答 参数 的 Kotlin 代码 也 跟 Java 的 做 法 类 似 , 一 样 要 调用 setResult 方法 
将 应 答 参数 返回 给 上 一 个 页 面 : 


btn act response.setOnClickListener { 











val response = MessageInfo (et_response.text.toString()， 
DateUtil.nowTime) 

val intent = Intent() 

intent .putExtra("message", response) 

// 调 用 setResult 方法 表示 携带 应 答 参数 返回 到 上 一 个 页 面 

setResult (Activity.RESULT OK, intent) 

finish() 

Fk 


上 一 个 页 面 接收 到 了 返回 的 应 答 数 据 ， 将 它 解 包 获得 原始 的 字段 信息 ， 再 做 进一步 的 处 理 。 
下 面 是 上 一 个 页 面 处 理 返回 数据 的 Kotlin 代码 例子 : 
// 从 下 一 个 页 面 返 回 到 本 页 面 时 回调 onActivityResult 方法 


override fun onActivityResult (requestCode: Int, resultCode: Int, data: 
Intent?) { 
if (data != null) { 
// 获 得 下 一 个 页 面 的 应 答 参 数 
val response = data.extras.getParcelable<MessageInfo> ("message") 
tv_request .text = " 收 到 返回 消息 : \n 应 答 时 间 为 ${response.send time}\n 
应 答 内 容 为 ${response.content}" 
} 





1 


以 上 页 面 跳 转 与 返回 的 数据 处 理 结果 如 图 6-30 和 图 6-31 所 示 ， 其 中 图 6-30 所 示 为 跳 到 下 一 
个 页 面 时 的 界面 截图 ， 图 6-31 所 示 为 返回 到 上 一 个 页 面 时 的 界面 截图 。 
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收 到 打包 好 的 请 求 消息 : 














请 求 时 间 为 09:25:01 你 吃饭 了 吗 ? 

请 求 内 容 为 你 吃饭 了 吗 ? 

吃 过 了 。 你 呢 ? | 传送 打包 好 的 请 求 参数 
收 到 返回 消息 : 

返回 应 答 参数 应 答 时 间 为 09:25:25 


应 答 内 容 为 吃 过 了 。 你 呢 ? 





图 6-30 下 一 个 页 面 准备 返回 应 答 消息 图 6-31 上 一 个 页 面 接收 返回 的 消息 


6.5 实战 项 目 : 电 商 App 的 登录 页 面 


在 这 个 移动 互联 网 时 代 ， 用 户 是 每 家 IT 企业 最 宝贵 的 资源 ， 但 凡 一 个 数 得 上 号 的 App， 无 不 
坐 拥 几 千 万 乃至 数 亿 的 用 户 ， 只 有 掌握 了 足够 多 的 用 户 ， 开 发 App 的 公司 才 会 被 资本 青睐 ， 才 有 
可 能 在 激烈 的 市 场 竞争 中 生存 下 去 。 那么 对 于 用 户 来 说 , 首次 打开 一 个 电 商 App 又 会 做 什么 事 呢 ? 
浏览 商品 固然 是 必 做 的 功课 ， 但 对 于 App 而 言 ， 吸 引用 户 注册 并 登录 才 是 紧要 之 事 ， 因 为 用 户 登 
录 之 后 才 有 机 会 产生 商品 交易 。 于 是 登录 功能 必然 是 电 商 App 的 一 个 重要 模块 ， 本 节 的 实战 项 目 
就 来 谈 谈 如 何 利 用 Kotlin 开发 一 个 功能 完备 的 登录 页 面 。 

6.5.1 需求 描述 

各 家 电 商 App 的 登录 页 面 大 同 小 异 ， 要 么 是 用 户 名 与 密码 组 合 登录 ， 要 么 是 手机 号 与 验证 码 
组 合 登 录 , 若是 做 好 一 点 的 ， 则 会 提供 忘记 密码 与 记 住 密码 等 功能 。 当 然 做 需求 具有 文字 描述 肯定 
是 不 行 的 , 一 定 要 有 界面 效果 图 配合 讲解 才 可 以 。 下 面 先 来 看 看 登录 页 面 的 效果 图 ， 因 为 有 两 种 组 
合 登 录 方式 ， 所 以 登录 页 面 也 分 成 两 个 效果 图 。 如 图 6-32 所 示 ， 这 是 选中 密码 登录 方式 时 的 界面 
如 图 6-33 所 示 ， 这 是 选中 验证 码 登 录 时 的 界面 。 

从 以 上 两 个 登录 效果 图 看 到 ， 密 码 登 录 与 验证 码 登 录 的 界面 主要 存在 以 下 几 点 区 别 

(1) 密码 /验证 码 输入 框 的 左 侧 标题 以 及 输入 框 内 部 的 提示 语 各 不 相同 。 

(2) 如 果 是 密码 登录 ， 就 需要 支持 找 回 密码 ; 如 果 是 验证 码 登 录 ， 就 需要 支持 向 用 户 手机 发 
送 验证 码 。 

(3) 密码 登录 可 以 提供 记 住 密码 功能 ， 而 验证 码 的 数值 每 次 都 不 一 样 ， 无 须 记 住 ， 也 没 法 
记 住 。 

对 于 找 回 密码 功能 ， 一 般 是 跳 到 单独 的 找 回 密码 页 面 ， 在 该 页 面 输入 和 确认 新 密码 ， 并 校 验 找 
回 密码 的 合法 性 〈 通 过 短信 验证 码 检查 ) ， 据 此 勾勒 出 密码 找 回 页 面 的 轮廓 概貌 ， 如 图 6-34 所 示 。 

在 找 回 密码 的 操作 过 程 当中 ， 为 了 更 好 地 增强 用 户 体 验 ， 有 必要 在 几 个 关键 节点 处 提醒 用 户 。 
比如 成 功 发 送 验 证 码 之 后 ,要 及 时 提示 用 户 注意 查收 短信 ,这 里 暂且 做 成 提示 对 话 框 的 形式 ， 如 图 
6-35 所 示 。 又 比如 密码 登录 成 功 之 后 ， 也 要 告知 用 户 已 经 成 功 登 录 ， 注 意 继续 后 面 的 操作 ， 登 录 
成 功 的 提示 信息 如 图 6-36 所 示 。 
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图 密码 登录 〇 验证 码 登 录 〇 密码 登录 @ 验证 三 登录 
手机 号 码 ， 手机 号 码 
确认 新 密码 
登录 密码 ; 忘记 密码 验证 码 ; 获取 验证 码 
验证 码 : 获取 验证 码 
口 记 住 密码 
登录 登录 确定 





图 6-32 选中 密码 登录 方式 时 的 界面 图 6-33 选中 验证 码 登录 时 的 界面 ”图 6-34 找 回 密码 页 面 的 界面 效果 


请 记 住 验证 码 和 








您 的 手机 号 码 是 159602 *** 本 ,其 
喜 你 通过 登录 验证 ， 点 击 “ 确 定 ” 按 
钮 返回 上 个 页 面 


手机 号 159602 **** ， 本 次 验证 码 


是 408667， 请 输入 验证 码 


SE 我 再 看 看 





图 6-35 发送 验 证 码 的 提示 框 图 6-36 登录 成 功 后 的 提示 框 


真是 想不到 ， 原 来 简 简单 单 的 一 个 登录 功能 就 得 考虑 这 么 多 需求 场景 。 可 是 仔细 想 想 ， 这 些 
需求 场景 都 是 必要 的 ， 其 目的 是 为 了 让 用 户 能 够 更 加 便捷 地 顺利 登录 。 正 所 谓 “ 台 上 十 分 钟 ， 台 
十 年 功 ”， 每 个 好 用 的 App 都 离 不 开 程 序 员 数 十 年 如 一 日 的 辛勤 工作 。 


6.5.2 ”开始 热身 : 提醒 对 话 框 AlertDialog 


手机 上 的 App 极 大 地 方便 了 人 们 的 生活 ， 很 多 业务 只 需 用 户 拇指 一 点 即 可 轻松 办 理 ， 然 而 这 
也 带 来 了 一 定 的 风险 ， 因 为 有 时 候 用 户 并 非 真 的 想 这 么 做 ， 只 是 不 小 心 点 了 一 下 而 已 ， 如 果 App 
不 做 任何 提示 的 话 ， 继 续 蚁 味 蚁 味 无 自 办 完 业务 ， 比 如 转 错 钱 了 、 误 删 资料 了 、 密 码 输 错 了 ， 造 成 
不 可 挽回 的 后 果 往往 令 用 户 追 悔 莫 及 。 所 以 对 于 部 分 关键 业务 ，App 为 了 避免 用 户 的 误 操作 ,很 有 
必要 弹出 消息 对 话 框 ， 提 醒 用 户 是 否 真 的 要 进行 此 项 操作 。 

这 个 提醒 对 话 框 便 是 App 开发 常见 的 AlertDialog， 说 起 这 个 AlertDialog， 安 卓 开 发 者 都 有 所 
耳闻 ， 该 对 话 框 不 外 乎 消息 标题 、 消 息 内 容 、 确 定 按钮 、 取 消 按钮 这 4 个 要 素 ， 若 是 使 用 Java 编 
码 显示 提醒 对 话 框 ， 基 本 跟 下 面 的 示例 代码 大 同 小 异 : 

AlertDialog.Builder builder = new AlertDialog.Builder (this) 7 

builder.setTitle ("尊敬 的 用 户 "); 

builder.setMessage (" 你 真 的 要 卸载 我 吗 ? ") ; 

builder.setPositiveButton ("残忍 卸载 ", new DialogInterface.OnClickListener() { 

@Override 

Public void onClick(DialogInterface dialog, int which) { 
tv_alert.setText ("虽然 依依 不 舍 ， 但 是 只 能 离开 了 "); 

} 
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Ds; 

builder .setNegativeButton (" 我 再 想 想 "，new DialogInterface.OnClickListener() { 
@Override 
Public void onClick(DialogInterface dialog, int which) { 

tv_alert.setText (" 让 我 再 陪 你 三 百 六 十 五 个 日 夜 ") ; 

Ds 

AlertDialog alert = builder.create(); 

alert.show(); 


显而易见 ， 上 述 的 Java 代码 非常 元 长 , 特别 是 两 个 按钮 的 点 击 事件 , 既 有 匿名 类 又 有 函数 重 载 ， 


令 人 不 堪 卒 读 。 现 在 尝试 将 以 上 的 Java 代码 转换 为 Kotlin 代码 ， 转 换 后 的 Kotlin 代码 如 下 所 示 : 


val builder = AlertDialog.Builder (this) 

builder.setTitle ("尊敬 的 用 户 ") 

builder.setMessage (" 你 真 的 要 卸载 我 吗 ? ") 

builder.setPositiveButton (" 残 忍 卸 载 ") { dialog, which -> tv_alert.text = " 虽 


然 依 依 不 售 ， 还 是 只 能 离开 了 "” } 


builder.setNegativeButton ("我 再 想 想 ") { dialog, which -> tv alert.text = "让 


我 再 陪 你 三 百 六 十 五 个 日 夜 ” } 


Val alert = builder.create() 
alert.show() 


这 下 看 来 点 击 事件 的 代码 在 很 大 程度 上 简化 了 ， 不 过 除 此 之 外 ， 整 块 代码 依然 显得 有 些 腑 肿 ， 


尤其 是 运用 了 建造 者 模式 的 Builder 类 ， 虽 然 表 面 上 增强 了 安全 性 ， 但 对 于 编码 来 说 其 实 是 累 奖 。 
因此 ，Anko 库 将 其 做 了 进一步 的 封装 ， 其 实 就 是 给 Context 类 添加 了 一 个 扩展 函数 alert， 具 体格 式 
如 “alert( 消 息 内 容 , 消息 标题 ){ 几 个 按钮 及 其 点 击 事件 }”， 简 化 后 的 Kotlin 弹 窗 代码 如 下 所 示 : 


alert (" 你 真 的 要 钾 载 我 吗 ? "， "尊敬 的 用 户 ") { 
PositiveButton (" 残 忍 卸 载 ") { tv_alert.text = "虽然 依依 不 舍 ， 还 是 只 能 离开 了 " } 
negativeButton ("我 再 想 想 ") { tv_alert.text = "让 我 再 陪 你 三 百 六 十 五 个 日 夜 ”} 
} .show() 
现在 的 Kotlin 代码 相 比 之 下 更 方便 阅读 了 ， 并 且 代码 量 还 不 到 原来 Java 代码 的 三 分 之 一 。 当 
为 了 正常 使 用 这 么 好 的 扩展 函数 ， 不 要 忘 了 在 代码 文件 头 部 加 入 下 面 一 行 导入 语句 : 
import org.jetbrains .anko.alert 


另外 , 要 修改 模块 的 build.gradle, 在 dependencies 节点 中 补充 下 述 的 anko-common 包 编译 配置 : 


compile "org.jetbrains.anko:anko-common: $anko_version" 


这 么 精简 的 Kotlin 代码 ， 功 能 上 可 是 一 点 都 没有 偷 工 





减 料 ， 它 的 提醒 对 话 框 效果 与 Java 编码 一 模 一 样 ， 都 如 图 RE 
6-37 所 示 。 
你 真 的 要 务 载 我 吗 ? 
点 击 提醒 对 话 框 两 个 按钮 之 后 的 界面 分 别 如 图 6-38 和 
图 6-39 所 示 ， 其 中 图 6-38 所 示 为 点 击 “ 残 忍 卸 载 ”之 后 的 我 要 要 


界面 ， 图 6-39 所 示 为 点 击 “ 我 再 想 想 ”之 后 的 界面 。 








图 6-37 ”提醒 对 话 框 的 例子 效果 
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6.5:3 


弹出 提醒 对 话 框 弹出 提醒 对 话 框 

虽然 依依 不 舍 ， 但 是 只 能 离开 了 让 我 再 陪 你 三 百 六 十 五 个 日 夜 

图 6.38 点击“ 残忍 印 载 ” 之 后 的 界面 图 6-39 点 击 “ 我 再 想 想 ” 之 后 的 界面 
控件 设计 


用 户 登 录 界面 看 似 简单 ， 用 到 的 控件 却 不 少 。 按 照 之 前 登录 界面 的 效果 图 ， 大 致 从 上 到 下 、 
从 左 到 右 分 布 着 下 列 Android 控件 。 


单 选 按 钮 RadioButton: 用 来 区 分 是 密码 登录 还 是 验证 码 登 录 。 

文本 视图 TextView: 输入 框 左 侧 要 显示 此 处 应 该 输入 什么 信息 。 

编辑 框 EditText: 用 来 输入 手机 号 码 和 密码 。 

复 选 框 CheckBox: 用 于 判断 是 否 记 住 密码 。 

按钮 Button: 除了 “登录 ”按钮 之 外 ， 还 有 “忘记 密码 ”和 “获取 验证 码 ” 两 个 按钮 。 
线性 布局 LinearLayout: 指定 手机 号 码 的 文本 视图 与 手机 号 码 的 编辑 框 从 左 到 右 依次 排列 。 
相对 布局 RelativeLayout: 忘记 密码 的 按钮 与 密码 输入 框 是 登 加 的 ， 且 “忘记 密码 ”与 上 级 视 
图 右 对 齐 。 

单 选 组 RadioGroup: 密码 登录 和 验证 码 登 录 这 两 个 单 选 按钮 需要 放 在 单 选 组 布局 之 中 。 


另外 ， 由 于 整个 登录 模块 由 登录 页 面 和 找 回 密码 页 面 组 成 ， 因 此 这 两 个 页 面 之 间 需 要 进行 数 
据 交 互 ， 也 就 是 在 页 面 跳 转 时 传递 参数 。 辟 如， 从 登录 页 面 跳 到 找 回 密码 页 面 要 携带 唯一 标识 的 手 
机 号 码 作为 请 求 参 数 ， 不 然 密码 找 回 页 面 不 知道 要 给 哪个 手机 号 修改 密码 。 同 时 ， 从 找 回 密码 页 面 
回 到 登录 页 面 , 也 要 将 修改 之 后 的 新 密码 作为 应 答 参数 传 回去 , 否则 登录 页 面 不 知道 密码 被 改 成 什 


委 。 











6.5.4 ”关键 代码 


为 了 方便 读者 更 好 、 更 快 地 使 用 Kotlin 编码 完成 登录 页 面 项 目 ， 下 面 列 举 几 个 重要 功能 的 
Kotlin 代码 片段 。 

1. 关于 自动 清空 错误 的 密码 

这 里 有 个 细微 的 用 户 体验 问题 ， 用 户 会 去 找 回 密码 ， 肯 定 是 发 现 输入 的 密码 不 对 ， 那 么 修改 
密码 完 回 到 登录 页 面 , 密码 输入 框 里 还 是 刚才 的 错误 密码 ,此 时 用 户 只 能 先 清空 错误 密码 , 然后 才 
能 输入 新 密码 。 一 个 App 要 想 让 用 户 觉得 好 用 ， 就 得 急用 户 之 所 急 ， 想 用 户 之 所 想 ， 像 刚才 那个 
错误 密码 的 情况 ， 应 当 由 App 在 返回 登录 页 面 时 自动 清空 原来 的 错误 密码 。 


自动 清 











室 密 码 框 的 操作 放 在 onActivityResult 方法 中 处 理 是 个 办 法 ， 但 这 样 有 个 问题 ， 如 果 用 





户 直 接 按 返 回 键 回 到 登录 页 面 ， 那 么 onActivityResult 方法 发 现 数据 为 空 便 不 做 处 理 。 因 此 应 该 这 


么 处 理 : 


判断 当前 是 否 为 返回 页 面 动作 ， 只 要 是 从 找 回 密码 页 面 返回 到 当前 页 面 ， 无 论 是 否 携带 应 
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答 参数 ， 均 需 自动 清空 密码 输入 框 。 对 应 的 Kotlin 代码 则 为 重 写 登录 页 面 的 onRestart 方法 ， 在 该 
方法 中 强制 清空 密码 。 这 样 一 来 ,无 论 用 户 是 修改 密码 完成 回 到 登录 页 ， 还 是 点 击 返回 键 回 到 登录 
页 ，App 都 会 自动 清空 密码 框 。 

下 面 是 重 写 onRestart 函数 之 后 的 Kotlin 代码 示例 : 

// 从 修改 密码 页 面 返回 登录 页 面 ， 要 清空 密码 的 输入 框 


Override fun onRestart() { 

















et password.setText ("") 
super.onRestart () 


} 


2. 关于 自动 隐藏 输入 法 面板 

在 输入 手机 号 码 或 者 密码 的 时 候 ， 屏 幕 下 方 都 会 弹出 输入 法 面板 ， 供 用 户 按键 输入 数字 和 字 
母 。 但 是 输入 法 面板 往往 占据 屏幕 下 方 大 块 空间 ， 很 是 碍 手 碍 脚 ， 用 户 输 完 11 位 的 手机 号 码 时 ， 
还 得 再 按 一 下 返回 键 来 关闭 输入 法 面板 ,接着 才能 继续 输入 密码 。 这 里 按 返 回 键 纯 属 庸 人 自 扰 ， 理 
想 的 做 法 是 : 一 旦 用 户 输 完 11 位 手机 号 码 ，App 就 要 自动 隐藏 输入 法 。 同 理 ， 一 旦 用 户 输 完 6 位 
密码 或 者 6 位 验证 码 ，App 也 要 自动 隐藏 输入 法 。 要 想 让 App 具备 这 种 智能 的 判断 功能 ， 就 需 给 
文本 编辑 框 添加 监听 器 ， 只 要 当前 编辑 框 输入 文本 长 度 达到 11 位 或 者 6 位 ，App 就 自动 将 输入 法 
面板 隐藏 。 

下 面 是 实现 智能 隐藏 功能 的 Kotlin 监听 器 代码 例子 : 


Private inner class HideTextWatcher (private val mView: EditText) : TextWatcher { 





Private val mMaxLength: Int = ViewUtil.getMaxLength (mView) 
Private var mStr: CharSequence? = null 


override fun beforeTextChanged(s: CharSequence, start: Int, count: Int, 
after: Int) 1{} 


override fun onTextChanged(s: CharSequence, start: Int, before: Int, count: 
Fn) 
mstr=s 
} 


override fun afterTextChanged(s: Editable) { 
if (mStr.isNullOrEmpty()) 
return 
if (mstr!!.length == 11 && mMaxLength == 11 || mSstr!!.length == 6 && 
mMaxLength == 6) { 
// 隐 藏 输入 法 面板 ，ViewUtil 类 参见 本 书 下 载 资源 中 的 源 代码 


ViewUtil.hideOneInputMethod (this@LoginPageActivity, mView) 
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3. 关于 找 回 密码 的 跳 转 事件 
因为 “ 找 回 密码 ”与 “获取 验证 码 ” 共 用 一 个 按钮 ， 所 以 点 击 事件 需要 区 分 当前 是 要 找 回 密 
码 还 是 获取 验证 码 。 如 果 是 找 回 密 码 ， 就 携带 手机 号 码 跳 到 密码 找 回 页 面 ; 如 果 是 获取 验证 码 ， 就 
在 界面 上 提示 用 户 注意 接收 验证 码 。 
下 面 是 “ 找 回 密码 ”/“ 获 取 验 证 码 ” 两 个 按钮 事件 合并 后 的 Kotlin 代码 示例 : 
Private fun doForget() { 
Val Phone = et phone.text.toString() 
if (phone.isBlank() || phone.length < 11) { 
toast ("请 输入 正确 的 手机 号 ") 


return 








if (rb password.isChecked) { 
// 携 带 手机 号 码 跳 到 密码 找 回 页 面 
startActivityForResult<LoginForgetActivity> (mRequestCode, "phone" to 
phone) 
} else if (rb verifycode.isChecked) { 
mVerifyCode = String.format ("%06d", (Math.random() * 1000000 % 
1000000) .toInt () ) 
alert (" 手 机 号 Sphone， 本 次 验证 码 是 SmVerifyCode， 请 输入 验证 码 "， "请 记 住 验证 码 ") { 
PositiveButton (" 好 的 ") { } 
} .show() 


有 
密码 修改 完毕 ， 在 登录 页 面 获 取 新 密码 的 Kotlin 代码 如 下 所 示 


override fun onActivityResult (requestCode: Int, resultCode: Int, data: Intent?) { 
if (requestCode == mRequestCode && data != null) { 
// 用 户 密码 已 改 为 新 密码 


mPassword = data.getStringExtra("new password") 


} 


4. 关于 密码 修改 的 校 验 操作 

由 于 密码 对 于 用 户 来 说 是 很 重要 的 信息 ， 因 此 必须 认真 校 验 新 密码 的 合法 性 ， 务 必 做 到 万 无 
一 失 才 行 。 具 体 的 密码 修改 校 验 可 分 为 下 列 4 个 步骤 : 

(1) 新 密码 和 确认 输入 的 新 密码 都 要 是 6 位 数字 。 

(2) 新 密码 和 确认 输入 的 新 密码 必须 保持 一 致 。 

(3) 用 户 输入 的 验证 码 必 须 和 系统 下 发 的 验证 码 一 致 。 

(4) 密码 修改 成 功 之 后 ， 携 带 修改 后 的 新 密码 返回 登录 页 面 。 

根据 以 上 的 校 验 步骤 ， 对 应 书写 的 Kotlin 代码 例子 如 下 所 示 : 
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Private fun doConfirm() { 

Val password first = et password first.text.toString() 

val password second = et password second.text.toString() 

if (password first.isBlank() || password first.length < 6 || 

Password second.isBlank() || password second.length < 6) { 

toast ("请 输入 正确 的 新 密码 ") 
return 

} else if (password first != password second) { 
toast ("两 次 输入 的 新 密码 不 一 致 ") 
return 

} else if (et verifycode.text.toString() != mVerifyCode) { 
toast ("请 输入 正确 的 验证 码 ") 
return 

} else { 
toast ("密码 修改 成 功 ") 
// 携 带 修改 后 的 新 密码 返回 登录 页 面 


val intent = Intent() .putExtra("new password", password first) 
setResult (Activity.RESULT OK, intent) 
finish() 


6.6 小 结 


本 章 主 要 介绍 了 Kotlin 如 何 实现 几 种 简单 控件 的 调用 ， 包 括 常 见 的 按钮 控件 (文本 按钮 、 复 
选 框 、 单 选 按钮 》、 主 要 的 布局 视图 (线性 布局 、 相 对 布局 、 约 束 布局 ) 、 基 本 的 图 文 控件 (文本 
视图 、 图 像 视图 、 文 本 编辑 框 》 以 及 Activity 活动 组 件 的 控制 操作 (携带 参数 、 启 动 模式 、 返 回 参 
数 ) 。 最 后 设计 了 一 个 实战 项 目 “ 电 商 App 的 登录 页 面 ”， 在 该 项 目的 Kotlin 编码 中 采用 了 前 面 
介绍 的 大 部 分 布局 和 控件 ， 以 及 Activity 跳 转 与 返回 时 的 消息 请 求 与 应 答 ， 另 外 还 介绍 了 Kotlin 对 
提醒 对 话 框 的 用 法 。 

通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 5 种 开发 技能 


(1) 学 会 使 用 Kotlin 操作 常见 的 按钮 控件 ， 除 了 复习 匿名 函数 、 内 部 类 、 接 口 、 字 符 串 模板 、 
分 支 语句 等 基础 语法 知识 之 外 ， 还 需 掌握 Kotlin 的 类 型 转换 办 法 。 

(2) 学 会 使 用 Kotlin 操作 主要 的 布局 视图 ， 除 了 掌握 这 些 布局 的 自身 功能 实现 之 外 ， 还 需 掌 
握 Anko 库 的 像素 转换 方法 、 相 对 视图 的 相对 位 置 设置 方法 。 

(3) 学 会 使 用 Kotlin 操作 基本 的 图 文 控件 ， 除 了 掌握 图 文 信息 的 各 种 特效 处 理 之 外 ， 还 需 重 
点 掌握 Kotlin 位 运算 符 的 概念 及 其 用 法 。 

(4) 学 会 使 用 Kotlin 操作 Activity 组 件 的 跳 转 过 程 ， 包 括 携带 配对 参数 跳 转 、 携 带 序列 化 参 
数 跳 转 、 跳 转 时 指定 启动 标志 、 携 带 应 答 参 数 返回 上 个 页 面 等 。 

(5) 学 会 使 用 Anko 库 简 化 提醒 对 话 框 的 调用 代码 。 























Kotlin 操纵 复杂 控件 


第 6 章 介绍 的 简单 控件 只 是 Android 界面 开发 的 基础 ， 若 想 让 App 界面 真正 活泼 起 来 ， 变 得 
烟 烟 生 辉 ， 还 需要 各 式 各 样 的 复杂 控件 来 组 合 运用 。 这 些 复 杂 控件 既 有 常见 的 视图 排列 控件 ， 又 有 
来 自 MaterialDesign 库 的 新 颖 布局 ， 更 有 横向 滑动 的 页 面 切换 控件 。 本 章 就 从 这 些 常 用 的 复杂 控件 
着 手 ， 一 边 介绍 它们 的 常规 用 法 ， 一 边 介绍 如 何 使 用 Kotlin 更 好 、 更 方便 地 操作 这 些 控件 。 


7.1 使 用 视图 排列 


虽然 Android 提供 了 很 多 控件 , 但 是 这 些 控件 不 能 随意 堆砌 ， 因 为 任何 事物 都 要 讲究 章法 ， 有 
章 可 循 才 不 会 乱 套 ,所 以 Android 还 提供 了 遵循 某 种 展现 规则 的 视图 排列 控件 ,包括 下 拉 框 Spinner、 
列表 视图 ListView、 网 格 视图 GridView、 循 环视 图 RecyclerView 等 。 本 节 就 对 这 几 种 视图 排列 控 
件 进行 详细 的 说 明 ， 特 别 曾 述 如 何 使 用 Kotlin 实现 它们 各 自 的 适配器 编码 。 


7.1.1 下 拉 框 Spinner 


对 于 某 些 固定 值 的 条 件 选择 ， 比 如 红 、 绿 、 蓝 三 原色 选择 其 一 ， 一 月 份 到 十 二 月 份 选择 其 中 
一 个 月 份 等 , 这 些 情况 在 Android 中 用 到 了 下 拉 框 Spinner。 界 面 上 的 Spinner 控件 一 开始 是 一 个 右 
侧 带 向 下 箭头 的 文本 ， 点 击 该 文本 会 弹出 一 个 选择 对 话 框 ， 选 中 某 一 项 之 后 ， 对 话 框 消失 ， 同 时 界 
面 上 的 文本 替换 为 刚才 选中 的 文本 内 容 。 只 看 下 拉 框 的 功能 其 实 挺 简单 的 ， 可 是 如 果 用 Java 代码 
实现 ， 就 得 费 一 番 功 夫 了 。 

下 面 便 是 调用 Spinner 控件 的 Java 代码 例子 : 

Private void initSpinner() { 
ArrayAdapter<String> starAdapter = new ArrayRdapter<String> (this, 
R.layout.item select, starArray); 
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starRAdapter.setDropDownViewResource (R.1ayout.item dropdown) 
Spinner sp = (Spinner) findViewById(R.id.sp dialog); 

sp .setPrompt ("请 选择 行星 ") ; 

sp.setAdapter (starAdapter); 

sp.setSelection(0); 

sp .setOnItemSelectedListener (new MySelectedListener ()); 


private String[] starArray = {" 水 星 "，" 金 星 "， "地球 "， "火星 "， "木星 "， "土星 "} ; 
class MySelectedListener implements OnItemSelectedListener { 
Public void onItemSelected (AdapterView<?> arg0, View argl, int arg2, 
long arg3) { 
Toast.makeText (SpinnerDialogActivity.this, "你 选择 的 行星 是 
"+starArray[arg2], Toast.LENGTH LONG) .show(); 
} 


Public void onNothingSelected (RdapterView<?> arg0) {} 


不 出 所 料 ， 这 里 再 次 体现 了 Java 编码 的 尾 大 不 掉 ， 简 简单 单 的 功能 在 Java 代码 中 被 分 解 为 以 
下 几 个 专门 的 处 理 : 


(1) 定义 一 个 数组 适配器 ArrayAdapter， 指 定 待 选 择 的 字符 串 数组 以 及 每 项 文本 的 布局 文件 。 

(2) 定义 一 个 选择 监听 器 OnItemSelectedListener， 它 在 用 户 选 中 某 项 时 触发 ， 并 响应 文本 项 
的 选中 事件 。 

(3) Spinner 控件 依次 设置 选择 对 话 框 的 标题 、 数 组 适配器 、 选 择 监听 器 、 默 认 选 项 等 。 

我 的 天 ， 这 也 太 专业 了 吧 ， 在 产品 经 理 看 来 ， 这 只 是 个 下 拉 框 而 已 ， 有 必要 搞 这 么 复杂 吗 ? 
然而 Java 代码 就 是 这 么 错综复杂 ， 要 想 开 发 Android， 只 能 这 么 做 ， 不 然 还 有 更 好 的 法 子 吗 ? 不 信 
换 成 Kotlin 试 试 ? 说 时 迟 那 时 快 , 在 Android Studio 上 面 把 Spinner 上 述 的 Java 代码 转换 为 Kotlin， 
不 一 会 儿 就 生成 了 如 下 的 Kotlin 代码 : 





Private fun initSpinner() { 
val starAdapter = ArrayAdapter (this, R.layout.item select, starArray) 
starAdapter.setDropDownViewResource (R.layout.item dropdown) 
//android 8.0 之 后 的 findViewById 方法 要 求 后 面 添加 "<View>" 才 能 进行 类 型 转换 操作 
val sp = findViewById<View>(R.id.sp dialog) as Spinner 
sp .Prompt = "请 选择 行星 " 
sp.adapter = starAdapter 
sp.setSelection(0) 
sp.onItemSelectedListener = MYSelectedListener () 


private val starArray = arrayOf(" 水 星 "， "金星 "， "地球 "， "火星 "， "木星 "， "土星 ") 
internal inner class MySelectedListener : OnItemSelectedListener { 
override fun onItemSelected (arg0: AdapterView<*>, argl: View, arg2: Int， 
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arg3: Long) { 
toast ("你 选择 的 行星 是 ${starArray[arg2]}") 
} 


override fun onNothingSelected (arg0: AdapterView<*>) {} 
下 


瞧 瞧 ， 号 称 终结 者 的 Kotlin 也 不 过 尔 尔 ， 整 体 代码 量 跟 Java 相 比 是 半斤八两 ， 丝 毫 不 见 往日 
的 威风 。 由 于 这 里 的 Java 代码 逻辑 实在 拐弯 抹 角 ， 既 有 数组 适配器 又 有 选择 监听 器 ， 因 此 Kotlin 
确实 没有 好 办 法 。 既 然 此 路 不 通 ， 那 就 试 试 别 的 办 法 ， 前 面 提 到 Spinner 其 实 由 两 部 分 组 成 ， 一 部 
分 是 直接 显示 在 界面 上 的 带 箭 头 文本 , 另 一 部 分 是 点 击 文本 后 弹出 的 选择 对 话 框 , 所 以 能 不 能 绕 过 
Spinner， 和 干脆 把 下 拉 框 分 离 成 两 个 控件 。 倘 若 仅仅 是 一 个 带 箭头 的 文本 ， 毫 无 疑问 使 用 文本 视图 
TextView 就 可 以 了 ， 箭 头 图 标 可 以 在 布局 文件 中 通过 drawableRight 属性 来 指定 。 
于 是 布局 文件 中 的 Spinner 节点 如 下 所 示 : 


<Spinner 








android:id="@+id/sp_dialog" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout toRightOof="@+id/tv dialog" 
android:gravity="left|center" 
android:spinnerMode="dialog" /> 


表面 上 完全 可 以 被 下 面 这 个 TextView 节点 所 取代 : 


<TextView 
android:id="@+id/tv spinner" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout toRightOof="@+id/tv dialog" 
android:gravity="center" 
android:drawableRight="@drawable/arrow_down" 
android:textColor="@color/black" 
android:textSize="1l7sp" /> 


如 果 再 来 一 个 选择 对 话 框 ， 这 样 只 要 给 该 文本 视图 添加 点 击 事件 ， 点 击 TextView 便 弹 出 选择 

框 , 岂 不 是 万 事 大 吉 ? 正巧 Anko 库 已 经 提供 了 这 股东 风 , 它 便 是 selector, 与 alert 一 样 来 自 于 Context 
的 扩展 函数 ， 调 用 格式 形 如 “selector( 对 话 框 标题 , 字符 串 队列 ) {i-> 第 i 项 的 选中 处 理 代码 }”。 
那么 将 selector 与 前 面 的 文本 视图 相 结合 ， 即 可 无 颖 实现 原来 的 下 拉 框 功能 ， 具 体 的 Kotlin 代码 如 
下 所 示 : 

val satellites = 1istOf ("水 星 "，" 金 星 "，" 地 球 "，" 火 星 "，" 木 星 "，" 土 星 ") 

tv_spinner.text = satellites[0] 

tv_spinner.setOnClickListener { 

selector ("请 选择 行星 "，satellites) { i -> 
tv_spinner.text = satellites[i] 
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toast ("你 选择 的 行星 是 ${tv_spinner .text}") 


下 
看 看 这 几 行 代码 ， 完 全 不 见 了 数组 适配器 和 选择 监听 器 的 踪影 ， 故 而 代码 量 一 下 剧 减 到 对 应 
Java 代码 的 三 分 之 一 。 当 然 ， 为 了 正常 地 使 用 selector 函数 ， 不 要 忘 了 在 代码 文件 头 部 加 入 下 面 一 
行 导入 语句 : 
import org.jetbrains.anko.selector 
另外 , 要 修改 模块 的 build.gradle, 在 dependencies 节点 中 补充 下 述 的 anko-common 包 编 译 配置 : 


compile "org.jetbrains.anko:anko-common: $anko version" 


虽然 把 布局 文件 里 面 的 Spinner 控件 换 成 TextView 控件 , 但 是 二 者 在 功能 上 是 没什么 区 别 的 ， 
同样 支持 点 击 文本 弹出 选择 框 ， 也 同样 支持 选中 某 项 的 回调 。 改 造 后 下 拉 框 的 完整 调用 效果 如 图 
7-1 一 图 7-3 所 示 ， 其 中 图 7-1 所 示 为 界面 上 的 下 拉 框 初始 文本 ， 图 7-2 所 示 为 点 击 文本 后 弹出 的 选 
择 对 话 框 ， 图 7-3 所 示 为 选中 某 项 后 的 下 拉 框 界面 。 








complex 


请 选择 行星 





图 7-1 下 拉 框 的 初始 界面 图 7-2 点击 下 拉 框 弹出 的 选择 对 话 框 

如 此 方便 易 用 的 selector， 竞 然 撤 开 了 数组 适 配 

器 和 选择 监听 器 , 那么 它 又 是 怎么 实现 的 呢 ? 认真 阅 
读 Anko 库 里 面 的 selector 源码 ， 发 现 原来 该 函数 利 














用 了 AlertDialog 的 setItems 方法 , 通过 setItems 方法 请 选择 行星 地 引 
指定 一 串 文本 , 并 且 定义 了 每 项 的 点 击 事件 ,其 运行 - 
结果 竟然 与 Spinner 的 选择 对 话 框 殊途同归 。 Ri 


下 面 给 出 AlertDialog 对 应 selector 函数 的 Java 实现 代码 ， 方 便 读者 理解 它 的 本 质 : 


AlertDialog.Builder builder = new AlertDialog.Builder (this); 

builder .setTitle ("请 选择 行星 ") ; 

builder.setItems (satellites, new DialogInterface.OnClickListener() { 
@Override 
Public void onClick(DialogInterface dialog, int which) { 
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Toast.makeText (SpinnerDialogActivity.this, "你 选择 的 行星 是 
"+starArray[arg2], Toast.LENGTH _ LONG) .show(); 
} 
5 
builder.create() .show() 7 


7.1.2 ”列表 视图 ListView 


7.1.1 小 节 介 绍 了 下 拉 框 只 有 在 弹出 选择 对 话 框 时 才 会 显示 列表 信息 ， 一 旦 回 到 主 界 面 ， 则 仅 
仅 展 示 选 中 的 记录 信息 。 相 比 之 下 ， 列 表 视 图 ListView 允许 将 整个 列表 信息 搬 到 主 界面 上 ， 使 得 
页 面 内 容 既 规整 又 丰富 ， 故 而 列表 视图 常用 于 展现 新 闻 列 表 、 商 品 列表 、 书 籍 列表 等 ， 方 便 用 户 逐 
行 浏览 与 操作 。 

为 实现 各 种 排列 组 合 类 的 视图 (包括 但 不 限于 下 拉 框 
Spinner、 下 拉 列 表 ListView、 网 格 视图 GridView 等 ), Android 


提供 了 五 花 八 门 的 适配器 用 于 组 装 某 个 规格 的 数据 ， 常 见 的 适 “| 个 各 i 








配器 有 数组 适配器 ArrayAdapter、 简 单 适配器 SimpleAdapter、 六 
基本 适配器 BaseAdapter、 翻 页 适配器 PagerAdapter。 适 配器 的 A 
种 类 虽 多 ， 却 个 个 都 不 好 用 ， 以 数组 适配器 为 例 ， 它 与 Spinner bo Er 
配合 实现 下 拉 框 效果 , 其 实现 代码 纷 复 繁杂 , 一 直 为 人 所 诉 病 。 2 
故而 在 下 拉 框 小 节 之 中 ， 干 脆 把 ArrayAdapter 连同 Spinner 一 A 
股 脑 都 气 弃 了 ， 取 而 代 之 的 是 Kotlin 扩展 函数 selector。 火星 

到 了 列表 视图 ListView 这 里 , 与 之 搭档 的 一 般 是 基本 适 配 ~ er Ei 
器 BaseAdapter， 这 个 BaseAdapter 更 不 简单 ， 基 于 它 的 列表 适 re a 
配器 得 重 写 好 几 个 方法 ， 还 有 那个 想 让 初学 者 撞墙 的 视图 持 有 全 大和 的 
者 ViewHolder。 总之， 每 当 要 实现 类 似 新 闻 列表 、 商 品 列表 之 了 


土星 为 太阳 系 八大 行星 之 一 ,排行 第 六 ,体积 
仅 次 于 本 星 


类 的 页 面 , 一 想到 这 个 难 缠 的 BaseAdapter， 心里 便 发 体 。 蔷 如 
图 7-4 所 示 的 六 大 行星 说 明 列表 ， 左 侧 为 图 标 ， 右 侧 为 文字 说 - 
明 ， 其 实 是 一 个 很 普通 的 页 面 。 图 7-4 没有 分 隔 线 的 行星 列表 


可 是 这 个 行星 列表 页 面 倘若 使 用 Java 编码 ， 就 得 书写 下 面 一 大 段 适配器 代码 : 


Public class PlanetJavaAdapter extends BaseAdapter { 








Private Context mContext; 
private ArrayList<Planet> mplanetList; 
private int mBackground; 


Public PlanetJavaAdapter (Context context, ArrayList<Planet> planet list, 
int background) { 
mContext = context; 
mPlanetList = planet list; 
mBackground = background; 
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@Override 
public int getCount() { 
return mpPlanetList.size(); 


@Override 
public Object getItem(int arg0) { 
return mPlanetList.get(arg0) 7 


@Override 
Public long getItemId(int arg0) { 
return arg07 


Q@Override 
Public View getView(final int position, View convertView, ViewGroup parent) { 
ViewHolder holder = null; 
if (convertView == null) { 
holder = new ViewHolder (); 
convertView = 
LayoutInflater.from(mContext) .inflate (R.layout.item list view, null); 
holder.11_item = (LinearLayout) 
ConvertView.findViewById(R.id.11_item) 7 
holder.iv icon = (ImageView) 
convertView.findViewById(R.id.iv icon) 7 
holder.tv_name = (TextView) 
convertView.findViewById(R.id.tv name); 
holder.tv desc = (TextView) 
convertView.findViewById(R.id.tv desc); 
convertView.setTag (holder); 
} else { 
holder = (ViewHolder) convertView.getTag(); 
} 
Planet planet = mPlanetList.get (position); 
holder.11 item.setBackgroundColor (mBackground); 
holder.iv icon.setImageResource (planet.image); 
holder.tv name.setText (planet .name); 
holder.tv desc.setText (planet .desc); 
return convertView; 


Public final class ViewHolder { 
Public LinearLayout 11 item; 
public ImageView iv icon; 
Public TextView tv_ name; 
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public TextView tv desc; 


1 


| | 


上 面 Java 代码 实现 的 适配器 类 PlanetJavaAdapter 果真 是 既 元 长 又 临 涩 ， 然 而 这 段 代 码 模板 基 
本 上 是 列表 视图 的 标 配 ， 只 要 用 Java 编码 ， 就 必须 依 样 画 标 。 如 果 用 Kotlin 实现 这 个 适配器 类 会 
是 怎样 的 呢 ? 马上 利用 Android Studio 把 上 述 Java 代码 转换 为 Kotlin 编码 ， 转 换 后 的 Kotlin 代码 


类 似 以 下 片段 : 


class PlanetKotlinAdapter (private val mContext: Context, private val 


mPlanetList: ArrayList<Planet>, private val mBackground: Int) : BaseAdapter() { 


override fun getCount(): Int { 
return mPlanetList.size 
} 
override fun getItem(arg0: Int): Any { 


return mPlanetList[arg0] 
} 


override fun getItemId(arg0: Int): Long { 
return arg0.toLong() 


override fun getView (position: Int, convertView: View?, parent: ViewGroup): 


View { 
Var View = convertView 
var holder: ViewHolder? 
if (view == null) { 
holder = ViewHolder() 
View = 
LayoutIinflater.from(mContext) .inflate(R.layout.item list view, null) 


holder.1] item = view.findViewById<View>(R.id.1] item) as 


LinearLayout 
holder.iv icon=view.findViewById<View> (R.id.iv icon) as ImageView 
holder.tv name = view.findViewById<View>(R.id.tv name) as TextView 
holder.tv desc = view.findViewById<View> (R.id.tv_ desc) as TextView 
View.tag = holder 
} else { 


holder = view.tag as ViewHolder 
} 
val planet = mPlanetList[Position] 
holder.11 item!!.setBackgroundColor (mBackground) 
holder.iv icon!!.setImageResource (Planet.image) 
holder.tv name! 
holder.tv desc!!.text = planet.desc 





.text = Planet.name 
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return view!! 

， 

inner class ViewHolder { 
var 11_item: LinearLayout? = null 
var iv icon: ImageView? = null 
Var tv name: TextView? = null 
Var tv _ desc: TextView? = null 


相 比 之 下 , 直接 转换 得 来 的 Kotlin 代码 最 大 的 改进 是 把 构造 函数 及 初始 化 参数 放 到 了 第 一 行 ， 
其 他 地 方 未 有 明显 优化 。 眼 睐 着 没 多 大 改善 ， 反 而 因为 Kotlin 的 空 安全 机 制 平 白 无 故 多 了 好 些 问 
号 和 双 感 叹 号 ， 可 谓 得 不 偿 失 。 问 题 出 在 Kotlin 要 求 每 个 变量 都 要 初始 化 上 面 ， 视 图 持 有 者 
ViewHolder 作为 一 个 内 部 类 ， 目 前 虽然 无 法 直接 对 控件 对 象 赋值 ， 但 是 从 代码 逻辑 可 以 看 出 ， 适 
配器 先 从 布局 文件 获取 控件 ， 然 后 才 会 调用 各 种 设置 方法 。 这 意味 着 ， 上 面 的 控件 对 象 必定 是 先 获 
得 实例 ， 在 它们 被 使 用 的 时 候 肯 定 是 非 空 的 ， 因 此 完全 可 以 告诉 编译 器 ， 这 些 控件 对 象 一 定 会 在 使 
用 前 赋值 ， 编 译 器 您 老 就 高 抬 贵 手 ， 睁 一 只 眼 闭 一 上 只 眼 放 行 好 了 。 

毋庸 置 疑 ， 该 想法 合情合理 ，Kotlin 正好 提供 了 这 种 后 门 ， 它 便 是 修饰 符 lateinit。lateinit 的 意 
思 是 延迟 初始 化 ， 把 它 放 在 var 或 者 val 前 面 ， 表 示 被 修饰 的 变量 属于 延迟 初始 化 属性 ， 即 使 没有 
初始 化 也 仍然 是 非 空 的 。 如 此 一 来 , 这 些 控件 在 声明 时 无 须 赋 空 值 ,在 使 用 的 时 候 也 不 必 画 蛇 添 足 
加 上 两 个 感叹 号 。 根 据 新 来 的 lateinit 修改 前 面 的 行星 列表 适配器 ， 改 写 后 的 Kotlin 适配器 代码 如 
下 所 示 : 

// 适 配器 的 属性 定义 及 其 初始 化 操作 在 主 构造 函数 中 自动 完成 

class PlanetListAdapter (Private val context: Context, private val planetList: 
MutableList<Planet>, private val background: Int) : BaseAdapter() { 

// 利 用 简化 函数 直接 用 等 号 连接 函数 体 


override fun getCount(): Int = PlanetList.size 
override fun getItem(Position: Int): Any = planetList[position] 
override fun getItemId(Position: Int): Long = Position.toLong() 


override fun getView (position: Int, convertView: View?, parent: ViewGroup) : 
View { 
Var View = convertView 
val holder: ViewHolder 
if (convertView == null) { 
View = LayoutIinflater.from(context) .inflate 
(R.layout.item list view, null) 
holder = ViewHolder () 
// 先 声明 视图 持 有 者 的 实例 ， 再 依次 获取 内 部 的 各 个 控件 对 象 
//findViewBYyId 后 面 直接 跟 上 “< 视图 类 型 >”， 即 可 起 到 关键 字 as 强制 转换 类 型 的 功能 
holder.11_item = view.findViewById<LinearLayout>(R.id.1l1 item) 
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holder.iv icon = view.findViewById<ImageView> (R.id.iv_ icon) 
holder.tv name = View.findViewById<TextView> (R.id.tv_name) 
holder.tv desc = view.findViewById<TextView>(R.id.tv desc) 
View.tag = holder 

} else { 
holder = view.tag as ViewHolder 

| 

val Planet = planetList[position] 

// 因 为 11_item 被 声明 为 延迟 初始 化 属性 ， 所 以 编译 器 认为 它 是 个 非 空 变量 ， 就 无 须 添加 

holder.11 item.setBackgroundColor (background) 

holder.iv icon.setImageResource (Planet.image) 

holder.tv name.text = planet.name 

holder.tv desc.text = planet.desc 

return view!! 


于 


//ViewHolder 中 的 属性 使 用 关键 字 lateinit 延迟 初始 化 
inner class ViewHolder { 
lateinit var 11_ item: LinearLayout 
lateinit var iv icon: ImageView 
lateinit var tv name: TextView 
lateinit var tv desc: TextView 


时 

以 上 的 Kotlin 代码 总 算 有 点 模样 了 ， 虽 然 总 体 代码 还 不 够 精简 ， 但 是 至 少 清晰 明了 ， 其 中 主 
要 运用 了 Kotlin 的 以 下 三 项 技术 : 

(1) 构造 函数 和 初始 化 参数 放 在 类 定义 的 首 行 ， 无 须 单独 构造 ， 也 无 须 手 工 初 始 化 。 

(2) 像 getCount、getItem、getItemld 这 三 个 函数 ， 仅 仅 返回 简单 运算 的 数值 ， 可 以 直接 用 等 
号 取代 大 括号 。 

(3) 对 于 视图 持 有 者 的 内 部 控件 ， 在 变量 名 称 前 面 添加 修饰 符 lateinit， 表 示 该 属性 为 延迟 初 
始 化 属性 。 

外 部 给 列表 视图 设置 对 应 的 适配器 ， 直 接 给 adapter 属性 赋值 即 可 。 下 面 是 设置 列表 视图 适 配 
器 的 Kotlin 代码 例子 : 


1V_Planet.adapter = PlanetListAdapter (this, Planet.defaultList, 





Color .WHITE) 


上 面 的 列表 视图 展示 行星 列表 的 效果 如 图 7-5 和 图 7-6 所 示 ， 其 中 图 7-5 所 示 为 只 存在 内 部 分 
割 线 时 的 行星 列表 界面 ， 图 7-6 所 示 为 存在 包括 头 尾 在 内 所 有 分 隔 线 时 的 行星 列表 界面 。 
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complex 
分 隔 线 显示 el 上 兴 全 










分 隔 线 显示 9 本 







水 星 水 星 

容量 四 要 人 大昌 也 是 小 的 一 实 呈 太 则 村 人 大生 昭和 全 也 是 小 的 一 其 
行星 ， 也 是 离 太阳 最 近 的 行 行星 ， 也 是 离 太阳 最 近 的 行 

金星 金星 







金星 是 太阳 系 八大 行星 之 一 ,排行 第 二 ， 距 离 
太阳 0.725 天 文 单位 


地 球 
地 球 是 太阳 系 八大 行星 之 一 排行 第 三 ， 也 


A 


火星 是 太阳 系 八大 行星 之 一 ， 排 行 第 四 ， 属 于 
类 地 行星 ， 直 径 约 为 地 球 的 53% 


金星 是 太阳 系 八大 行星 之 一 ,排行 第 二 ， 距离 
太阳 0.725 天 文 单位 


地 球 

地 球 是 太阳 系 八大 行星 之 一 ， 排 行 第 三 
太阳 系 中 直径 、 站 各 各 
距离 太阳 1.5 亿 公里 


二 而 
人 ts 属于 
类 地 行星 ， 直 径 约 为 地 球 的 












木星 是 太阳 系 八大 行星 中 体积 最 大 、 自 转 最 快 

= 的 行星 ， 排 行 第 五 。 它 的 质量 为 太阳 的 二 分 之 
一 ， 但 为 太阳 系 中 其 它 七 大 行星 质量 总 和 的 
土星 


土星 为 太阳 系 八大 行星 之 一 ， 排 行 第 六 ， 体 积 
仅 次 于 木星 
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， 但 为 太阳 系 中 其 它 七 大 行星 质量 总 和 的 


土星 
土星 为 太阳 系 八大 行星 之 一 ,排行 第 六 ， 体 积 
仅 次 于 木星 


木星 
木星 是 太阳 系 八大 行星 中 体积 最 大 、 自 转 最 忆 
一 的 行星， 排行 第 五 








图 7-5 只 有 内 部 分 隔 线 的 行星 列表 图 7-6 拥有 头 尾 分 隔 线 的 行星 列表 


7.1.3 网 格 视图 GridView 


除了 列表 视图 外 ， 网 格 视图 GridView 也 是 一 类 常见 的 适配器 视图 ， 它 用 于 分 行 分 列 显示 表格 
信息 ， 可 以 达到 更 紧凑 的 界面 效果 ， 因 而 比 ListView 更 适合 展示 商品 清单 。 

网 格 视图 同样 需要 通过 适配器 展示 网 格 数据 ，7.1.2 小 节 ListView 使 用 的 基本 适配器 
BaseAdapter 也 能 用 于 GridView。 在 前 面 的 列表 视图 代码 中 ， 给 出 了 Kotlin 改写 后 的 适配器 类 
PlanetListAdapter, 其 中 通过 修饰 符 lateinit 固然 避免 了 麻烦 的 空 校 验 , 可 是 控件 对 象 迟早 要 初始 化 ， 
晚 赋 值 不 如 早 赋 值 。 翻 到 前 面 适配器 PlanetListAdapter 的 实现 代码 ， 认 真 观察 发 现 控件 对 象 的 获取 
其 实 依赖 于 布局 文件 的 视图 对 象 view。 既 然 如 此 ， 不 妨 把 该 视图 对 象 作 为 ViewHolder 的 构造 参数 
传 过 去 ， 使 得 视图 持 有 者 在 构造 时 便 能 一 起 初始 化 内 部 的 控件 对 象 。 

据 此 ， 改 写 后 的 Kotlin 适配器 代码 如 下 所 示 : 

// 适 配器 的 属性 定义 及 其 初始 化 操作 在 主 构造 函数 中 自动 完成 


class PlanetGridAdapter (private val context: Context, private val planetList: 
MutableList<Planet>, private val background: Int) : BaseAdapter() { 






// 利 用 简化 函数 直接 用 等 号 连接 函数 体 


override fun getCount(): Int = planetList.size 
override fun getItem(Position: Int): Any = planetList[position] 


override fun getItemId (Position: Int): Long = position.toLong() 
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override fun getView (position: Int, convertView: View?, parent: ViewGroup) : 
View { 
Var View = convertView 
val holder: ViewHolder 
if (view == null) { 
View = 
LayoutInflater.from(context) .inflate(R.layout.item grid view, null) 
holder = ViewHolder (view) 
// 视 图 持 有 者 的 内 部 控件 对 象 已 经 在 构造 时 一 并 初始 化 了 ， 故 这 里 无 须 再 做 赋值 
View.tag = holder 
} else { 
holder = view.tag as ViewHolder 
} 
val planet = planetList[position] 
//11_itenm 在 构造 时 就 被 初始 化 ， 理 所 当然 是 个 非 空 变量 
holder.11_ item.setBackgroundColor (background) 
holder.iv icon.setImageResource (Planet.image) 
holder.tv_name .text = Planet.name 
holder.tv_desc.text = Planet.desc 


return view!! 


//ViewHolder 中 的 属性 在 构造 时 初始 化 

inner class ViewHolder (val view: View) { 
//findViewById 后 面 直接 跟 上 “< 视图 类 型 >”， 即 可 起 到 关键 字 as 强制 转换 类 型 的 功能 
val 11 item: LinearLayout = 

view.findViewById<LinearLayout>(R.id.1] item) 

val iv_icon: ImageView = view.findViewById<ImageView> (R.id.iv_ icon) 
val tv name: TextView = View.findViewById<TextView> (R.id.tv_name) 
Val tv desc: TextView = view.findViewById<TextView>(R.id.tv desc) 


} 

外 部 若 要 调用 改进 后 的 网 格 适配器 ， 直 接 给 网 格 视图 的 adapter 属性 赋值 即 可 。 下 面 是 设置 网 
格 视图 适配器 的 Kotlin 代码 例子 : 

gv_ planet .adapter = PlanetGridAdapter (this, Planet.defaultList, 

Color .WHITE) 

接着 运行 测试 应 用 ， 得 到 的 行星 网 格 效果 如 图 7-7 和 图 7-8 所 示 ， 其 中 图 7-7 所 示 为 不 存在 分 
割 线 时 的 行星 网 格 界 面 ， 图 7-8 所 示 为 存在 分 隔 线 时 的 行星 网 格 界面 。 

至 此 ， 基 于 BaseAdapter 的 Kotlin 列表 /网 格 适 配器 告 一 段落 ， 上 述 的 适配器 代码 模板 同时 适 
用 于 列表 视图 ListView 与 网 格 视图 GridView。 
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分 隔 线 显示 不 显示 分 隔 线 分 旺旺 示 显示 全 部 分 多 用 padding 
水 星 金星 水 星 a 
站 


5 
直人 的 一， 扣 大 有 0.725 天 


地 球 火星 


斌 星 是 太阳 系 八大 行星 之 一 
也 是 商 河 中 南 太 阳 0.725 夫 





行 第 三 ， 也 是 大 阳 各 中 Es 
对 质量 各 密度 最 大 的 类 直行 ee 
旺 ， 距 元 太阳 1.5 亿 公里 

土星 
-4 

















本 是 坟 阳 么 八大 行星 中 体积 主星 为 太阳 系 八大 行星 之 一 ， | 本 旺 足 太阳 么 八大 行星 中 体 职 睹 星 为 太阳 系 八大 行星 之 一 ， 





图 7-7 没有 分 隔 线 的 行星 网 格 图 7-8 拥有 分 隔 线 的 行星 网 格 


7.1.4 ”循环 视图 RecyclerView 


循环 视图 是 一 种 功能 更 加 强大 的 列表 类 视图 ， 它 能 够 实现 三 种 列表 形式 : 线性 列表 、 网 格 列 
表 、 瀑布 流 网 格 。 由 于 RecyclerView 是 Android 5.0 之 后 的 新 增 控件 ， 因 此 为 了 兼容 以 前 的 Adnroid 
版 本 ， 在 使 用 该 控件 前 要 修改 build.gradle， 在 dependencies 节点 中 加 入 下 面 一 行 表示 导入 
recyclerview 库 : 
// 需 要 将 “$supportVersion” 替 换 为 读者 电脑 上 的 v7 库 版 本 号 
compile "com.android.support:recyclerview-v7:$supportVersion" 
循环 视图 之 所 以 功能 强大 ， 是 因为 它 实现 了 一 些 特效 处 理 ， 而 不 再 仅 限于 简单 的 信息 陈列 。 
这 些 特效 处 理 主要 包括 三 点 : 更 完备 的 方法 调用 、 布 局 管理 器 以 及 循环 适配器 。 
1. 更 完备 的 方法 调用 
RecyclerView 提供 了 几 个 特效 要 求 的 方法 ， 当 然 有 部 分 方法 在 Kotlin 中 可 转 为 属性 操作 ， 这 
些 方法 在 Kotlin 和 Java 之 间 的 调用 方式 对 比 见 表 7-1。 
表 7-1 循环 视图 有 关 方 法 /属性 的 Kotlin 和 Java 调用 方式 对 比 
方法 /属性 说 明 Kotlin 的 调用 方式 Java 的 调用 方式 
设置 列表 项 的 布局 管理 器 layoutManager setLayoutManager 
设置 列表 项 的 适配器 adapter setAdapter 
设置 列表 项 的 增删 动画 itemAnimator setltemAnimator 
添加 列表 项 的 分 隔 线 addItemDecoration addltemDecoration 




















2. 布局 管理 器 
布局 管理 器 LayoutManager 是 RecyclerView 的 精 藤 ， 也 是 RecyclerView 之 所 以 强悍 的 源泉 。 


第 7 章 Kotlin 操纵 复杂 控件 | 157 


它 不 但 提供 了 三 类 布局 管理 ， 分 别 实现 类 似 列表 视图 、 网 格 视图 、 瀑 布 流 网 格 的 效果 ， 而 且 可 在 代 
码 中 随时 由 循环 视图 对 象 通过 layoutManager 属性 设置 新 的 布局 ， 一 旦 设置 了 layoutManager 属性 ， 
界面 就 会 根据 新 布局 刷新 列表 项 。 这 个 特性 尤其 适合 于 手机 在 竖 屏 与 横 屏 之 间 的 显示 切换 (如 竖 屏 
时 展示 列表 ， 横 屏 时 展示 网 格 ) ， 也 适合 在 不 同 屏幕 分 辩 率 〈 如 手机 与 平板 ) 之 间 的 显示 切换 (如 
在 手机 上 展示 列表 ， 在 平板 上 展示 网 格 ) 。 下 面 对 这 三 类 布局 管理 器 分 别 进行 概要 介绍 。 
(1 ) 线性 布局 管理 器 LinearLayoutManager 
LinearLayoutManager 类 似 于 线性 布局 LinearLayout， 当 它 是 垂直 方向 布局 时 ， 展 示 效 果 类 似 
垂直 的 列表 视图 ListView; 当 它 是 水 平方 向 布局 时 ， 展 示 效 果 类 似 水 平 的 列表 视图 。 
(2 ) 网 格 布局 管理 器 GridLayoutManager 
GridLayoutManager 类 似 于 网 格 布局 GridLayout (该 控件 是 Android 4.0 之 后 新 加 的 控件 ) ， 但 
从 展示 效果 来 看 , GridLayoutManager 类 似 于 网 格 视图 GridView。 所 以 ,开发 者 不 用 关心 GridLayout， 
就 把 GridLayoutManager 当成 GridView 一 样 使 用 就 好 了 。 


(3) 瀑布 流 网 格 布局 管理 器 StaggeredGridLayoutManager 

电 商 App 在 展示 众多 商品 信息 时 ， 往 往 使 用 高 度 灵活 的 高 低 格 子 来 展示 。 因 为 不 同 商品 的 外 
观 尺寸 很 不 一 样 ， 比 如 冰箱 是 高 高 的 在 纵向 上 长 ,空调 则 是 在 横向 上 长 ， 所 以 车 用 一 样 规格 的 网 格 
来 展示 , 必然 有 的 商品 图 片 被 压缩 得 很 小 。 这 种 情况 下 得 根据 不 同 的 商品 形状 来 展示 不 同 高 度 的 图 
片 , 这 就 是 瀑布 流 网 格 的 应 用 场合 。StaggeredGridLayoutManager 让 瀑布 流 效果 的 开发 大 大 简化 了 ， 
开发 者 只 要 在 适配器 中 动态 设置 每 个 网 格 的 高 度 ， 系 统 便 会 自动 在 界面 上 依次 排列 瀑布 流 网 格 。 


3. 循环 适配器 

循环 视图 有 专门 的 适配器 类 ， 即 循环 适配器 RecyclerView.Adapter。 在 设置 RecyclerView 的 
adapter 属性 之 前 ,要 先 实现 一 个 从 RecyclerView.Adapter 派生 而 来 的 数据 适配器 , 用 来 定义 列表 项 
的 布局 与 具体 操作 。 总 的 来 说 ，RecyclerView.Adapter 与 前 面 遇 到 的 BaseAdapter 在 处 理 流 程 上 是 
基本 一 臻 的， 当然 它们 之 间 也 有 不 小 的 差异 ， 下 面 是 循环 适配器 和 其 他 适配器 的 主要 区 别 : 


(1) 自 带 视图 持 有 者 ViewHolder 及 其 重用 功能 ， 无 须 开发 者 手工 重用 ViewHolder。 
(2) 未 自 带 列 表 项 的 点 击 和 长 按 功能 ， 需 要 开发 者 自己 实现 点 击 和 长 按 事 件 的 监听 。 
(3) 增加 区 分 不 同 列表 项 的 视图 类 型 ， 方 便 开 发 者 根据 类 型 加 载 不 同 的 布局 。 

(4) 可 单独 对 个 别 项 进行 增删 改 操 作 ， 而 无 须 刷 新 整个 列表 。 


前 面 两 小 节 在 介绍 列表 视图 和 网 格 视图 时 , 它们 的 适配器 代码 都 存在 视图 持 有 者 ViewHolder， 
因为 Android 对 列表 类 视图 提供 了 回收 机 制 ， 所 以 如 果 某 些 列表 项 在 屏幕 上 看 不 到 了 ， 系 统 就 会 自 
动 回 收 相应 的 视图 对 象 。 随 着 用 户 的 下 拉 或 者 上 拉手 势 ,已 经 被 回收 的 列表 项 会 重新 加 载 到 界面 上 ， 
倘若 每 次 加 载 列 表 项 都 得 从 头 创 建 视图 对 象 ， 势 必 增 加 系统 的 资源 开销 。 所 以 ViewHolder 便 应 运 
而 生 ， 它 在 列表 项 首次 初始 化 时 ， 就 将 其 视图 对 象 保存 起 来 ， 后 面 再 次 加 载 该 视图 时 ， 即 可 直接 从 
持 有 者 处 获得 先前 的 视图 对 象 ， 从 而 减少 系统 开销 ， 提 高 系统 的 运行 效率 。 

视图 持 有 者 的 设计 理念 固然 美好 ， 却 苦 了 Android 开发 者 ， 因 为 每 次 由 BaseAdapter 派生 新 的 
适配器 类 ， 都 必须 手工 处 理 视图 持 有 者 的 相关 逻辑 ， 实 在 是 个 沉重 的 负担 。 鉴 于 此 ,循环 视图 适 配 
器 把 视图 持 有 者 的 重用 逻辑 剥离 出 来 , 由 系统 自行 判断 并 处 理 持 有 者 的 重用 操作 。 开发 者 编码 继承 
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RecyclerView.Adapter 之 后 ， 只 要 完成 业务 上 的 代码 逻辑 即 可 ， 无 须 进行 类 似 BaseAdapter 视图 持 
有 者 的 手工 重用 。 
现在 由 Kotlin 实现 循环 视图 适配器 ， 综 合 前 面 两 小 节 提 到 的 优化 技术 ， 加 上 视图 持 有 者 的 自 
用 ,适配器 代码 又 得 到 了 进一步 的 精简 。 由 于 循环 视图 适配器 并 不 提供 列表 项 的 点 击 事件 ， 因 
此 开发 者 要 自己 编写 包括 点 击 、 长 按 在 内 的 事件 处 理 代码 。 为 方便 理解 循环 适配器 的 Kotlin 编码 ， 
下 面 以 微 信 公 众 号 消息 列表 为 例 给 出 对 应 的 消息 列表 Kotlin 代码 : 
//ViewHolder 在 构造 时 初始 化 布局 中 的 控件 对 象 
class RecyclerLinearAdapter (Private val context: Context, private val infos : 
MutableList<RecyclerInfo>) : RecyclerView.Adapter<ViewHolder>(), 


OnItemClickListener, OnItemLongClickListener { 
val inflater: LayoutInflater = LayoutInflater.from(context) 

















// 获 得 列表 项 的 数目 


override fun getItemCount(): Int = infos.size 


// 创 建 整个 布局 的 视图 持 有 者 
override fun onCreateViewHolder (parent: ViewGroup, viewType: Int): 
ViewHolder { 
val view: View = inflater.inflate(R.layout.item recycler linear, parent, 
false) 
return ItemHolder (view) 


// 绑 定 每 项 的 视图 持 有 者 
override fun onBindViewHolder (holder: ViewHolder, position: Int) { 
val vh: ItemHolder = holder as ItemHolder 
vh.iv pic.setIimageResource (infos [position] .pic_id) 
vh.tv title.text = infos[position] .title 
Vvh.tv desc.text = infos[position] .desc 
// 列表 项 的 点 击 事件 需要 自己 实现 
vh.11_item.setOnClickListener { V -> 
itemClickListener?.onItemClick(v, position) 
} 
vh.11_item.setOnLongClickListener { v -> 
itemLongClickListener?.onItemLongClick(v, position) 
true 


//ItemHolder 中 的 属性 在 构造 时 初始 化 


inner class ItemHolder (view: View) : RecyclerView.ViewHolder(view) { 
var 11 item = View.findViewById<LinearLayout>(R.id.11_ item) 
var iv pic = view.findViewById<ImageView> (R.id.iv pic) 
var tv title = view.findViewById<TextView>(R.id.tv title) 
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var tv desc = view.findViewById<TextView>(R.id.tv desc) 
’ 
// 自 定义 点 击 事件 监听 器 
Private var itemClickListener: OnItemClickListener? = null 
fun setOnItemClickListener(listener: OnItemClickListener) { 
this.itemClickListener = listener 
T 


// 自 定义 长 按 事件 监听 器 

Private Var itemLongClickListener: OnItemLongClickListener? = null 

fun setOnIitemLongClickListener(listener: OnItemLongClickListener) { 
this.itemLongClickListener = listener 

, 


override fun onItemClick(view: View, position: Int) { 
val desc = "您 点 击 了 第 $ {position+1} 项 ， 标 题 是 ${infos [position] .title}" 
context .toast (desc) 


D 


override fun onItemLongClick(view: View, position: Int) { 
val desc = "您 长 按 了 第 $ {position+1} 项 ， 标 题 是 ${infos [position] .title}" 
context .toast (desc) 


} 


接 下 来 ， 外 部 就 可 以 对 循环 视图 对 象 运用 Kotlin 版 本 的 循环 适配器 了 ， 具 体 的 Kotlin 调用 代 

码 如 下 所 示 : 
rv_linear.layoutManager = LinearLayoutManager (this) 
val adapter = RecyclerLinearAdapter (this，RecyclerInfo.defaultList) 
adapter.setOnItemClickListener (adapter) 
adapter.setOnItemLongClickListener (adapter) 
rv linear.adapter = adapter 
rv linear.itemAnimator = DefaultItemanimator () 
rv_linear.addItemDecoration (SpacesItemDecoration (1)) 


以 上 的 循环 适配器 代码 初步 实现 了 公众 号 消息 列表 的 展示 
页 面 ， 具 体 的 列表 效果 如 图 7-9 所 示 。 

可 是 这 个 循环 适配器 RecyclerLinearAdapter 仍然 体 量 庞大 ， 
细 细 观察 发 现 其 实 它 有 着 数 个 与 具体 业务 无 关 的 属性 与 方法 , 璧 
如 上 下 文 对 象 context、 布 局 载 入 对 象 inflater、 点 击 监听 器 
itemClickListener、 长 按 监听 器 itemLongClickListener 等 ， 故 而 
完全 可 以 把 这 些 通用 部 分 提取 到 一 个 基 类 , 然后 具体 业务 再 从 该 
基 类 派生 出 特定 的 业务 适配器 类 。 根据 这 种 设计 思路 , 提取 出 了 
循环 视图 基础 适配器 ， 它 的 Kotlin 代码 如 下 所 示 : 








图 7.9 仿 微 信 公 众 号 的 消息 列表 
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// 循 环视 图 基础 适配器 
abstract class RecyclerBaseAdapter<VH : RecyclerView.ViewHolder> (val context: 
Context) : RecyclerView.Adapter<RecyclerView.ViewHolder>(), OnItemClickListener, 
OnItemLongClickListener { 
val inflater: LayoutInflater = LayoutIinflater.from(context) 


// 获 得 列表 项 的 个 数 ， 需 要 子 类 重 写 


override abstract fun getItemCount () : Int 


// 根 据 布局 文件 创建 视图 持 有 者 ， 需 要 子 类 重 写 
override abstract fun onCreateViewHolder (Parent: ViewGroup, viewType: Int) : 


RecyclerView.ViewHolder 


// 绑 定 视图 持 有 者 中 的 各 个 控件 对 象 ， 需 要 子 类 重 写 
override abstract fun onBindViewHolder (holder: RecyclerView.ViewHolder, 


Position: Int) 
override fun getItemViewTYyPpe (Position: Int): Int = 0 


override fun getItemId (Position: Int): Long = Position.toLong() 


Var itemClickListener: OnItemClickListener? = null 
fun setOnItemClickListener (1istener: OnItemClickListener) { 
this.itemClickListener = listener 


Var itemLongClickListener: OnItemLongClickListener? = null 
fun setOnItemLongClickListener (listener: OnItemLongClickListener) { 
this.itemLongClickListener = listener 


override fun onItemClick(view: View, position: Int) {} 


override fun onItemLongClick(view: View, position: Int) {} 
} 


一 旦 有 了 这 个 基础 适配器 ， 实 际 业 务 的 适配器 即 可 由 此 派生 而 来 ， 真 正 需 要 开发 者 编写 的 代 
码 一 下 精简 了 不 少 .下 面 便 是 一 个 循环 视图 的 网 格 适配器 , 它 实现 了 类 似 淘宝 主页 的 网 格 频 道 栏目 ， 
具体 的 Kotlin 代码 如 下 所 示 : 

// 把 公共 属性 和 公共 方法 剥离 到 基 类 RecyclerBaseAdapter 

// 此 处 仅 需 实 现 getItemCount、onCreateViewHolder、onBindViewHolder 三 个 方法 ， 以 及 视 
图 持 有 者 的 类 定义 

class RecyclerGridAdapter (context: Context, private val infos: 
MutableList<RecyclerInfo>) : 
RecyclerBaseAdapter<RecyclerView.ViewHolder> (Context) { 


override fun getItemCount (): Int = infos.size 


override fun onCreateViewHolder (parent: ViewGroup, viewType: Int) : 
RecyclerView.ViewHolder { 
val view: View = inflater.inflate(R.layout.item recycler grid, parent, 
false) 
return ItemHolder (view) 


. 


override fun onBindViewHolder (holder: RecyclerView.ViewHolder, position: 
Tau)y 
val vh = holder as ItemHolder 
vh.iv pic.setImageResource (infos[position] .pic id) 
vh.tv title.text = infos[Position] .title 


inner class ItemHolder (View: View) : RecyclerView.ViewHolder (view) { 
var 11_item = view.findViewById<LinearLayout>(R.id.1]1 item) 
var iv pic = view.findViewById<ImageView> (R.id.iv pic) 
var tv title = view.findViewById<TextView>(R.id.tv title) 


} 


下 面 依旧 由 外 部 通过 循环 视图 对 象 调用 改进 后 的 网 格 适 配器 ， 对 应 的 Kotlin 调用 代码 示例 

如 下 : 
rv grid.layoutManager = GridLayoutManager (this, 5) 
val adapter = RecyclerGridAdapter (this, RecyclerInfo.defaultGrid) 
adapter.setOnItemClickListener (adapter) 
adapter.setOnItemLongClickListener (adapter) 
rv _ grid.adapter = adapter 
rv_grid.itemAnimator = DefaultItemAnimator () 
rv_grid.addItemDecoration (SpacesItemDecoration(1)) 


改进 后 的 循环 网 格 适配器 运行 之 后 的 界面 效果 如 图 7-10 所 
示 ， 无 颖 实现 了 原来 需要 数 十 行 Java 代码 才能 实现 的 功能 。 
然而 基 类 手段 不 过 是 周 虫 小 技 ，Java 也 照样 能 够 运用 , 所 |@@ 多 命 9 


以 这 根本 不 入 Koulin 的 法 眼 ， 要 想 超 越 Java， 还 得 拥有 独 ] 秘 | 多 名 国 珊 路 


籍 才 行 。 注 意 ， 适 配器 代码 仍然 通过 findViewById 方法 获得 控 | 人 # 店 饭店 餐厅 人 iF 菜市 声 








件 对 象 ， 可 是 号 称 在 Anko 库 的 支持 之 下 ，Kotlin 早 就 无 须 该 广 
法 即 可 直接 访问 控件 对 象 ， 为 什么 这 里 依旧 靠 老 牛 拉 破 车 呢 ? 图 7-10 仿 淘宝 频道 的 分 类 网 格 
其 中 的 缘由 是 Anko 库 仅仅 实现 了 Activity 活动 页 面 的 控件 自动 获取 ， 并 未 实现 适配器 内 部 的 自动 
获取 。 当 然 ，Kotlin 早 就 料 到 了 这 一 手 ， 为 此 专门 提供 了 一 个 插件 LayoutContainer， 只 要 开发 者 让 
自 定 义 的 ViewHolder 类 实现 该 接口 ， 即 可 在 视图 持 有 者 内 部 自动 获取 并 直接 使 用 控件 对 象 。 这 下 
无 论 是 在 Activity 代码 还 是 在 适配器 代码 中 ， 均 可 将 控件 名 称 拿 来 直接 调用 。 

这 么 神奇 的 魔法 ， 快 来 看 看 优化 后 的 Kotlin 适配器 代码 是 如 何 书写 的 : 
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// 利 用 Kotlin 的 插件 Layoutcontainer 在 适配器 中 直接 使 用 控件 对 象 ， 而 无 须 对 其 进行 显 式 声明 

class RecyclerStaggeredAdapter (context: Context, private val infos: 
MutableList<RecyclerInfo>) : RecyclerBaseAdapter<RecyclerView.ViewHolder> 
(context) { 


override fun getItemCount () : Int = infos.size 


override fun onCreateViewHolder (parent: ViewGroup, viewType: Int) : 
RecyclerView.ViewHolder { 
val view: View = inflater.inflate(R.layout.item recycler staggered, 
parent, false) 
return ItemHolder (view) 
} 


override fun onBindViewHolder (holder: RecyclerView.ViewHolder, position: 
EE 
(holder as ItemHolder) .bind(infos [Position]) 
} 


// 注 意 这 里 要 去 掉 inner， 否 则 运行 报错 “java.1lang.NoSuchMethodError: No virtual 
method $ findCachedViewById” 
class ItemHolder (override val containerView: View?) 
RecyclerView.ViewHolder (containerView), LayoutContainer { 
fun bind(item: RecyclerInfo) { 
// 因 为 运用 了 插件 LayoutContainer， 所 以 这 里 可 以 直接 使 用 控件 对 象 
iv_pic.setImageResource (item.pic id) 
tv_ title.text = item.title 


} 

当然 ， 为 了 能 够 正常 使 用 该 功能 ， 需 要 在 适配器 代码 头 部 加 上 以 下 两 行 代码 ， 其 中 第 一 行 代 
码 表示 引用 Kotlin 的 扩展 插件 LayoutContainer， 第 二 行 代码 表示 导入 指定 布局 文件 里 面 所 有 控件 
对 象 : 

import kotlinx.android.extensions.LayoutContainer 

import kotlinx.android.synthetic.main.item recycler staggered.* 

另外 ， 因 为 LayoutContainer 是 Kotlin 针对 性 提供 给 Android 的 扩展 插件 ， 所 以 需要 修改 模块 
的 build.gradle， 在 文件 末尾 添加 下 面 几 行 配置 ， 表 示人 允许 引用 安 卓 插件 库 : 

//LayoutContainer 需要 设置 experimental = true 

androidExtensions { 





experimental = true 


} 


即使 修改 后 的 瀑布 流 适 配器 代码 用 到 了 新 插件 ， 外 部 仍旧 同 原来 一 样 给 循环 视图 设置 适配器 ， 
以 下 的 Kotlin 调用 代码 并 无 任何 变化 : 





第 7 章 ”Kotlin 操纵 复杂 控件 | 163 


rv_staggered.layoutManager = StaggeredGridLayoutManager (3, 
LinearLayout .VERTICAL) 

// 第 一 种 方式 : 使 用 采取 LayoutContainer 的 插件 适配器 

val adapter = RecyclerStaggeredAdapter (this，RecyclerInfo.defaultStag) 

rv_staggered.adapter = adapter 

rv _ staggered.itemAnimator = DefaultItemRnimator () 

rv_staggered.addItemDecoration (SpacesItemDecoration (3)) 


上 面 采用 了 新 的 适配器 插件 ， 似 乎 已 经 大 功 告 成 ， 可 是 依然 要 书写 单独 的 适配器 代码 ， 仔 细 
研究 发 现 这 个 RecyclerStaggeredAdapter 还 有 三 个 要 素 是 随 着 具体 业务 而 变化 的 ， 参 见 如 下 说 明 : 


(1) 列表 项 的 布局 文件 资源 编码 ， 如 R.layout.item_recycler_staggered 。 
(2) 列表 项 信息 的 数据 结构 名 称 ， 如 RecyclerInfo 。 
(3) 对 各 种 控件 对 象 的 设置 操作 ， 如 ItemHolder 类 的 bind 方法 。 


除了 以 上 三 个 要 素 外 ， 适 配器 RecyclerStaggeredAdapter 内 部 的 其 余 代 码 都 是 允许 复 用 的 ， 因 
此 , 接 下 来 的 工作 就 是 想 办 法 把 这 三 个 要 素 抽象 为 公共 类 的 某 种 变量 。 对 于 第 一 个 布局 编码 ， 可 以 
考虑 将 其 作为 一 个 整 型 的 输入 参数 ， 对 于 第 二 个 数据 结构 , 可 以 考虑 定义 一 个 模板 类 ,在 外 部 调用 
时 再 指定 具体 的 数据 类 ; 对 于 第 三 个 bind 方法 ， 若 是 Java 编码 早已 束手无策 ， 现 用 Kotlin 编码 正 
好 将 该 方法 作为 一 个 函数 参数 传 入 。 

依照 上 述 三 个 要 素 的 三 种 处 理 对 策 ， 进 而 提炼 出 来 了 循环 适配器 的 通用 工具 类 
RecyclerCommonAdapter， 详 细 的 Kotlin 通用 适配器 定义 代码 示例 如 下 : 


// 循 环视 图 通用 适配器 

// 将 具体 业务 中 会 变化 的 三 类 要 素 抽 取出 来 ， 作 为 外 部 传 进来 的 变量 。 这 三 类 要 素 包括 : 

// 布 局 文件 对 应 的 资源 编号 、 列 表 项 的 数据 结构 、 各 个 控件 对 象 的 初始 化 操作 

class RecyclerCommonRdapter<T> (context: Context, private val layoutId: Int, 
Private val items: List<T>, val init: (View, T) -> Unit) : 
RecyclerBaseAdapter<RecyclerCommonAdapter.ItemHolder<T>> (context) { 


override fun getItemCount () : Int = items.size 


override fun onCreateViewHolder (parent: ViewGroup, viewType: Int) : 
RecyclerView.ViewHolder { 
val view: View = inflater.inflate(layoutId, parent, false) 
return ItemHolder<T> (view, init) 
b 


override fun onBindViewHolder (holder: RecyclerView.ViewHolder, position: 
Tnty 
val vh: ItemHolder<T> = holder as ItemHolder<T> 
Vvh.bind (items .get (Position) ) 
| 


// 注 意 init 是 一 个 函数 形式 的 输入 参数 
class ItemHolder<in T> (val view: View, val init: (View, T) -> Unit) : 
RecyclerView.ViewHolder (view) { 
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fun bind(item: T) { 
init(view item) 


} 


} 


有 了 这 个 通用 适配器 ， 外 部 声明 循环 适配器 只 需 像 函数 调用 那样 传 入 这 三 种 变量 就 好 了 ， 具 
体 的 Kotlin 调用 代码 如 下 所 示 : 


// 第 二 种 方式 : 使 用 把 三 类 可 变 要 素 抽象 出 来 的 通用 适配器 
val adapter = RecyclerCommonAdapter (this, 
R.layout.item recycler staggered, RecyclerInfo.defaultSstag, 
{view, item -> 
val iv pic = view.findViewById<ImageView> (R.id.iv pic) 
val tv title = view.findViewById<TextView>(R.id.tv title) 
iv pic.setIimageResource (item.pic id) 
tv title.text = item.title 


}) 
rv_staggered.adapter = adapter 
瞧 瞧 ， 最 终 出 炉 的 瀑布 流 适配器 仅 有 不 到 10 行 的 代码 ， 其 中 的 关键 技术 一 一 函数 参数 真是 不 


鸣 则 已 、 一 鸣 惊 人 。 至 此 ， 本 节 的 适配器 实现 过 程 终于 落下 帷幕 ， 一 路 上 可 谓 是 过 五 关 斩 六 将 ， 硬 





生生 把 数 十 行 的 Java 代码 压缩 到 不 足 10 行 的 Kotlin 代码 ,经 过 不 断 从 代 优 化 方 取得 如 此 上 项 炳 战绩 。 
尤其 是 最 后 的 两 种 实现 方式 ， 分 别 运用 了 Kotlin 的 多 项 综合 技术 ， 才 能 集 Kotlin 精妙 语法 之 大 成 。 


这 两 种 实现 方式 的 瀑布 流 效 果 是 一 样 的 ， 具 体 演示 用 的 服装 列表 界面 如 图 7-11 和 图 7-12 所 示 ， 其 
中 图 7-11 所 示 为 服装 列表 的 初始 界面 ， 图 7-12 所 示 为 上 拉 列 表 之 后 的 服装 界面 。 











图 7-11 服装 频道 的 瀑布 流 列表 初始 界面 图 7-12 瀑布 流 列表 上 拉 之 后 的 服装 界面 
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7.2 ”使 用 材质 设计 MaterialDesign 


MaterialDesign 库 是 Android 在 界面 设计 方面 做 出 重大 提升 的 增强 库 ， 该 库 提供 了 协调 布局 
CoordinatorLayout、 应 用 栏 布局 AppBarLayout、 可 折 著 工具 栏 布局 CollapsingToolbarLayout 等 新 颖 
控件 ， 这 几 个 新 加 的 布局 控件 结合 工具 栏 Toolbar 能 够 实现 导航 栏 动态 伸 缩 的 效果 。 本 节 就 对 头 部 
导航 栏 动态 特效 的 实现 过 程 进行 逐步 地 说 明 ， 最 后 总 结 起 来 叙述 仿 支付 宝 首页 的 头 部 伸缩 动画 
效果 。 


7.2.1 协调 布局 CoordinatorLayout 


Android 自 5.0 之 后 对 UI 做 了 较 大 的 提升 ， 一 个 重大 的 改进 是 推出 了 MaterialDesign 库 ， 而 该 
库 的 基础 即 为 协调 布局 CoordinatorLayout， 几 乎 所 有 的 design 控件 都 依赖 于 该 布局 。 所 谓 协 调 布 
局 ， 指 的 是 内 部 控件 互相 之 间 存 在 着 动作 关联 ， 比 如 在 A 视图 的 位 置 发 生变 化 时 ，B 视图 的 位 置 
也 按照 某 种 规则 来 变化 ， 仿 佛 弹 钢 琴 有 了 协奏曲 一 般 。 

使 用 协调 布局 CoordinatorLayout 时 ， 要 注意 以 下 两 点 : 


(1) 需要 给 模块 导入 design 库 ， 即 修改 build.gradle， 在 dependencies 节点 中 加 入 下 面 一 行 表 
示 导 入 design 库 : 
// 需 要 将 “$supportVersion” 替 换 为 读者 电脑 上 的 design 库 版 本 号 


compile 'com.android.support:design:$supportVersion' 


(2) 根 布局 采用 android.support.design.widget.CoordinatorLayout， 且 该 节点 要 添加 命名 空间 声 
明 xmlns:app="http://schemas.android.com/apk/res-auto"。 使 用 协调 布局 的 具体 XML 文件 示例 如 下 : 
<android.support.design.widget.CoordinatorLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 

xmlns:app="http://schemas.android.com/apk/res-auto" 

android:id="@+id/cl main" 

android:layout width="match parent" 

android:layout height="match parent" > 

<!-- 此 处 省 略 内 部 的 视图 节点 --> 


</android.support.design.widget.CoordinatorLayout> 
协调 布局 CoordinatorLayout 继承 自 ViewGroup, 它 的 实现 效果 类 似 于 相对 布局 RelativeLayout， 
若 要 指定 子 视图 在 整个 页 面 中 的 位 置 ， 则 有 以 下 几 个 办 法 : 
(1) 使 用 layout_gravity 属性 ， 指 定子 视图 在 CoordinatorLayout 内 部 的 对 齐 方 式 。 
(2) 使 用 app:layout_anchor 和 app:layout_anchorGravity 属性 ， 指 定子 视图 相对 于 其 他 子 视图 
的 位 置 。 其 中 ，app:layout_anchor 表示 当前 以 哪个 视图 作为 参照 物 ，app:layout_anchorGravity 表示 
本 视图 相对 于 参照 物 的 对 齐 方 式 。 
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(3) 使 用 app:layout behavior 属性 ， 指 定子 视图 相对 于 其 他 视图 的 行为 ， 当 对 方 的 位 置 发 生 
变化 时 ， 本 视图 的 位 置 也 要 随 之 变化 。 


接 下 来 ， 为 了 说 明 协调 布局 的 “协调 ”含义 ， 先 来 看 一 个 具体 的 例子 ， 这 个 例子 用 到 了 悬浮 
按钮 FloatingActionButton 。 悬 浮 按钮 是 design 库 提供 的 一 个 特效 按钮 ， 它 继承 自 图 像 按 钮 
ImageButton， 除 了 图 像 按 钮 的 所 有 功能 之 外 ， 还 提供 了 以 下 的 额外 功能 : 


(1) 悬浮 按钮 会 悬浮 在 其 他 视图 之 上 ， 即 使 布局 文件 中 别 的 视图 在 它 后面 ， 悬 浮 按钮 也 仍然 
显示 在 最 前 面 。 

(2) 在 隐藏 和 显示 悬浮 按钮 时 会 播放 切换 动画 ， 其 中 隐藏 按钮 操作 调用 了 hide 方法 ， 显 示 按 
钮 操作 调用 了 show 方法 。 

(3) 悬浮 按钮 默认 会 随 着 便签 条 Snackbar 的 出 现 或 消失 而 动态 调整 位 置 。 


下 面 是 演示 协调 布局 中 悬浮 按钮 FloatingActionButton 与 便签 条 Snackbar 联动 的 布局 文件 
例子 : 


<android.support.design.widget.CoordinatorLayout xmlns:android= 
"http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/cl main" 
android:layout width="match parent" 
android:layout height="match parent" > 


<LinearLayout 
android:id="@+id/11 main" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<Button 
android:id="@+id/btn_snackbar" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout_ gravity="center" 
android:layout marginTop="30dp" 
android:text=" 显 示 简 单 提 示 条 " 
android:textColor="@color/black" 
android:textSize="17sp"” /> 


<Button 
android:id="@+id/btn floating" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center™" 
android:layout marginTop="30dp" 
android:text=" 隐 藏 悬浮 按钮 " 
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android:textColor="@color/black" 
android:textSize="17sp" /> 
</LinearLayout> 


<android.support.design.widget.FloatingActionButton 

android:id="@+id/fab btn" 

android:layout width="80dp" 

android:layout height="80dp" 

android:layout margin="20dp" 

app:layout anchor="@id/1l1 main" 

app:layout anchorGravity="bottom|right" 

android:background="@drawable/float btn" /> 
</android.support.design.widget.CoordinatorLayout> 


与 上 述 布局 对 应 的 Kotlin 演示 代码 很 简单 ， 仅 仅 在 点 击 按钮 时 弹出 便签 条 , 调用 代码 如 下 所 示 : 
btn_snackbar.setOnClickListener { 


Snackbar.make (cl main, "这 是 个 提示 条 "，Snackbar. LENGTH LONG) .show() 
} 


由 于 便签 条 在 屏幕 底部 弹出 之 后 ， 短 暂停 留 几 秒 便 收缩 消失 ， 如 此 一 进 一 出 之 间 ， 即 可 观察 
悬浮 按钮 与 便签 条 的 协调 联动 具体 的 悬浮 按钮 位 置 变化 效果 如 图 7-13 一 图 7-15 所 示 , 其 中 图 7-13 
展示 便签 条 弹出 之 前 的 界面 ， 此 时 悬浮 按钮 位 于 屏幕 右 下 方 ; 图 7-14 展示 便签 条 弹出 之 后 的 界面 ， 
此 时 悬浮 按钮 随 着 便签 条 一 齐 向 上 抬升 一 段 距离 ， 图 7-15 展示 便签 条 回 缩 之 后 的 界面 ， 此 时 悬浮 
按钮 跟着 下 移 ， 并 恢复 到 原来 的 屏幕 位 置 。 





图 7-13 便签 条 未 弹出 时 的 界面 。 图 7-14 便签 条 弹出 之 后 的 界面 。 图 7-15 便签 条 回 缩 之 后 的 界面 


7.2.2 工具 栏 Toolbar 





主流 App 除了 底部 有 一 排 标 签 栏 之 外 ， 通 常 顶 部 还 有 一 排 导航 栏 ， 在 Android 5.0 之 前 ， 这 个 
顶部 导航 栏 是 以 ActionBar 控件 的 形式 出 现 ， 但 ActionBar 存在 着 不 灵活 、 难 以 扩展 等 毛病 ， 所 以 
Android 5.0 之 后 推出 了 Toolbar 工具 栏 控件 ， 意 在 取代 ActionBar。 

不 过 为 了 兼容 之 前 的 版 本 ， 原 有 的 ActionBar 控件 仍然 保留 ， 可 是 Toolbar 与 ActionBar 都 占 
着 顶部 导航 栏 的 位 置 ， 所 以 要 想 引 入 Toolbar 就 得 先 关 闭 ActionBar。 有 具体 的 替换 操作 步骤 如 下 : 


CJ01 在 stylesxml 中 定义 一 个 不 包含 ActionBar 的 风格 样式 ， 代 码 例子 如 下 所 示 : 





<style name="AppCompatTheme" parent= 
"Theme .AppCompat .Light .NoActionBar" /> 
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02 修改 AndroidManifestxml， 把 activity 节点 的 android:theme 


格 ， 如 android:theme="(@style/AppCompatTheme"。 





属性 值 改 为 第 一 步 定 义 的 风 


人 3 把 页 面 布局 文件 的 根 节点 改 为 LinearLayout， 且 为 vertical 垂直 方向 ， 然 后 增加 一 个 
Toolbar 节点 ， 因 为 Toolbar 本 质 是 一 个 ViewGroup， 所 以 也 可 以 在 它 下 面 添加 别 的 控件 。 下 面 是 一 个 








Toolbar 节点 的 布局 例子 片段 : 


<android.support.v7.widget.Toolbar 
android:id="@+id/tl1 head" 
android:layout width="match parent" 
android:layout height="wrap_content" /> 


JJ04 Activity 代码 需要 继承 AppCompatActivity， 其 实在 Android Studio 中 新 建 模块 已 经 是 默 


认 继 承 AppCompatActivity 了 。 








人 05 最 后 在 onCreate 函数 中 获取 布局 文件 中 的 Toolbar 对 象 ， 并 调用 setSupportActionBar 方 


法 设置 当前 的 Toolbar 对 象 。 


工具 栏 Toolbar 之 所 以 比 ActionBar 灵活 ， 除 了 人 允许 开发 者 自行 添加 下 级 控件 之 外 ， 还 有 一 个 
原因 是 它 提供 了 多 个 方法 和 属性 来 指定 自 带 控件 的 风格 。 下 面 是 使 用 Toolbar 设置 控件 风格 的 


Kotlin 代码 片段 : 


class ToolbarActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 


super.onCreate (savedInstanceState) 


setContentView(R.layout .activity toolbar) 


// 设 置 工具 栏 的 主 标题 文本 内 容 

tl1_head.title = "这 是 工具 栏 的 主 标题 " 

// 设 置 工具 栏 的 主 标题 文本 颜色 

tl head.setTitleTextColor (Color .RED) 

// 设 置 工具 栏 左边 的 Logo 图 标 

tl] head.setLogo(R.drawable.ic launcher) 
// 设 置 工具 栏 的 副标题 文本 内 容 
t1_head.subtitle = "这 是 副标题 " 

// 设 置 工具 栏 的 副标题 文本 颜色 





t1_head.setSubtit1leTextColor (Color .YELLOW) 


// 设 置 工具 栏 的 背景 


t1_head.setBackgroundResource (R.color.blue_1ight) 


// 使 用 Toolbar 替换 系统 自 带 的 ActionBar 
setSupportActionBar (tl head) 
// 工 具 栏 最 左 侧 的 导航 图 标 ， 通 常用 作 返 回 按钮 


tl head.setNavigationIcon(R.drawable.ic back) 


// 最 左 侧 导 航 图 标的 点 击 事件 ， 即 返回 上 一 个 页 面 


// 该 方法 必须 放 到 setsupportActionBar 之 后 ， 不 然 不 起 作用 
tl head.setNavigationOnClickListener { finish() } 
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有 具体 的 工具 栏 演示 效果 如 图 7-16 所 示 ， 该 工具 栏 的 界面 元 素 包括 导航 图 标 、 工 具 栏 图 标 、 标 
题 、 副 标题 等 。 






该 页 面 演示 工具 栏 功能 





图 7-16 工具 栏 的 演示 界面 


7.2.3 ”应 用 栏 布局 AppBarLayout 


前 面 提 到 Android 推出 工具 栏 Toolbar 用 来 蔡 代 ActionBar， 使 得 导航 栏 的 灵活 性 和 易 用 性 大 
大 增强 。 可 是 仅仅 使 用 Toolbar， 还 是 有 些 呆 板 ， 比 如 说 Toolbar 固定 占据 着 页 面 顶 端 ， 既 不 能 跟 
着 页 面 主体 移 上 去 , 也 不 会 跟着 页 面 主体 拉 下 来 ,为 了 让 App 页 面 更 加 生动 活泼 , 势必 要 求 Toolbar 
在 某 些 特定 的 场景 上 移 或 者 下 拉 ， 如 此 才能 满足 酷 炫 的 页 面 特效 需求 。 为 此 ，Android 5.0 推出 了 
MaterialDesign 库 ， 通 过 该 库 中 的 协调 布局 和 本 小 节 要 介绍 的 应 用 栏 布局 AppBarLayout， 将 这 两 种 
布局 结合 起 来 对 Toolbar 加 以 包装 ， 从 而 实现 顶部 导航 栏 的 动态 变化 效果 。 

应 用 栏 布局 AppBarLayout 其 实 继承 自 线性 布局 LinearLayout， 所 以 它 具 备 LinearLayout 的 所 
有 属性 与 方法 ， 除 此 之 外 ， 应 用 栏 布局 的 额外 功能 主要 有 以 下 几 点 : 


(1) 支持 响应 页 面 主体 的 滑动 行为 ， 即 在 页 面 主体 进行 上 移 或 者 下 拉 时 ，AppBarLayout 能 够 
捕 提 到 页 面 主体 的 滚动 操作 。 

(2) 捕捉 到 滚动 操作 之 后 ， 还 要 通知 头 部 控件 〈 通 常 是 Toolbar) ， 告 诉 头 部 控件 你 要 怎么 
滚 ， 是 爱 怎 么 滚 就 怎么 滚 ， 还 是 满 大 街 滚 。 

顶部 导航 栏 的 动态 滚动 效果 具体 到 实现 上 ， 则 要 在 App 工程 中 做 如 下 修改 : 

(1) 在 build.gradle 中 添加 几 个 库 的 编译 支持 ,包括 appcompat-v7 库 (Toolbar 需要 ) 、design 
库 (AppBarLayout 需要 ) 、recyclerview 库 〈 主 页 面 的 RecyclerView 需要 ) 。 

(2) 布局 文件 的 根 布局 采用 CoordinatorLayout， 因 为 design 库 的 动态 效果 都 依赖 于 该 控件 ， 
并 且 该 节点 要 添加 命名 空间 声明 xmlns:app="http://schemas.android.com/apk/res-auto"。 

(3) 使 用 AppBarLayout 节点 包 庄 Toobar 节点 ， 也 就 是 将 Toobar 节点 作为 AppBarLayout 节 
点 的 下 级 节点 。 

(4) 给 Toobar 节点 添加 滚动 属性 app:layout_scrollFlags="scrolllenterAlways"， 指 定 工具 栏 的 
滚动 行为 标志 。 

(5) 演示 界面 的 页 面 主体 使 用 RecyclerView 控件 ， 并 给 该 控件 节点 添加 行为 属性 ， 即 
app:layout_behavior="(@string/appbar_scrolling_view_behavior" ， 表 示 通 知 AppBarLayout 捕捉 
RecyclerView 的 滚动 操作 。 


下 面 是 AppBarLayonut 结合 RecyclerView 的 布局 文件 例子 : 





<android.support.design.widget.CoordinatorLayout xmlns:android= 
"http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas .android.com/apk/res-auto" 
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android:id="e@+id/c1l main" 
android:layout width="match parent" 
android:layout height="match parent" > 


<android.support.design.widget.AppBarLayout 
android:id="@+id/abl title" 
android:layout width: 
android:layout height="wrap content" > 





"match parent" 


<android.support.v7.widget.Toolbar 
android:id="@+id/tl1 title" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/blue light" 
app:layout_ scrollFlags="scrolllenterAlways" /> 
</android.support .design.widget.AppBarLayout> 


<android.support.v7.widget.RecyclerView 
android:id="@+id/rv main" 
android:layout width="match parent" 
android:layout height="match parent" 
app:layout behavior="@string/appbar _ scrolling view behavior" /> 


</android.support.design.widget.CoordinatorLayout> 
与 上 述 布局 文件 对 应 的 Kotlin 页 面 代码 如 下 所 示 : 
class AppbarRecyclerActivity : AppCompatActivity() { 


private val yearArray = arrayOf (" 鼠 年 "，" 牛 年 "，" 虎 年 "，" 免 年 "，" 龙 年 "，" 蛇 
年 "，" 马 年 "，" 羊 年 "，" 猴 年 "，" 鸡 年 "，" 狗 年 "，" 猪 年 ") 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity appbar recycler) 
setSupportActionBar (tl title) 
rv main.layoutManager = LinearLayoutManager (this) 
rv main.adapter = RecyclerCollapseAdapter (this, yearArray) 


} 


应 用 栏 布局 配合 循环 视图 的 演示 效果 如 图 7-17 一 图 7-19 所 示 , 其 中 图 7-17 展示 打开 演示 页 的 
初始 界面 ， 此 时 工具 栏 位 于 页 面 顶部 ， 图 7-18 展示 上 拉 一 小 段 时 的 界面 ， 此 时 工具 栏 随 着 向 上 滚 
动 一 段 ; 图 7-19 展示 上 拉 一 大 段 时 的 界面 ， 此 时 工具 栏 滚动 到 屏幕 之 外 ， 完 全 看 不 见 了 。 





图 7-17 应 用 栏 搭配 循环 视图 的 。 图 7-18 应 用 栏 上 拉 一 小 段 时 的 图 7-19 应 用 栏 上 拉 一 大 段 时 的 
初始 演示 界面 循环 视图 界面 循环 视图 界面 


虽然 通过 AppBarLayout 能 够 实现 Toolbar 的 滚动 效果 ， 但 并 非 所 有 可 滚动 的 控件 都 会 触发 
Toolbar 滚动 ， 事 实 上 只 有 Android 5.0 之 后 新 增 的 少数 滚动 控件 才 具 备 该 特技 。RecyclerView 是 
怀 的 绝技 之 一 , 它 可 用 来 蔡 代 列表 视图 ListView 和 网 格 视图 GridView; 而 替代 滚动 视图 ScrollView 
的 另 有 其 人 ， 它 便 是 嵌 套 滚动 视图 NestedScrollView， 在 Android 5.0 之 后 的 v4 库 中 提供 。 

NestedScrollView 继承 自 框架 布局 FrameLayout， 其 用 法 与 ScrollView 相似 ， 例 如 都 必须 且 只 
能 带 一 个 直接 子 视 图 ， 都 允许 内 部 视图 上 下 滚动 等 。NestedScrollView 多 出 来 的 功能 则 是 跟 
AppBarLayout 配合 使 用 ， 借 由 触发 Toolbar 的 滚动 行为 ， 可 把 它 当 作 兼 容 Android 5.0 新 特性 的 增 
强 版 ScrollView 。 

下 面 是 AppBarLayout 结合 NestedScrollView 的 布局 文件 例子 : 


<android.support.design.widget.CoordinatorLayout xmlns:android= 
"http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/cl main" 
android:layout width="match parent" 
android:layout height="match parent" > 


<android.support.design.widget.AppBarLayout 
android:id="@+id/abl title" 
android:layout width="match parent" 
android:layout height="wrap_content" > 


<android.support .v7.widget.Toolbar 
android:id="@+id/t] title" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
app:layout_scrollFlags="scroll|enterAlways" 
android:background="@color/blue light" /> 
</android.support .design.widget.AppBarLayout> 


<android.support.v4.widget.NestedScrollView 
android:id="@+id/nsv main™ 
android:layout width="match parent" 
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android:layout height="wrap content" 
app:layout behavior="@string/appbar scrolling view behavior" > 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" 
android:orientation="vertical" > 


<TextView 
android:layout width="match parent" 
android:layout height="100dp" 
android:background="#ffaaaa" 
android:gravity="center" 
android:text="hello" 
android:textColor="#000000" 
android:textSize="17sp" /> 


<TextView 
android:layout width="match parent" 
android:layout height="800dp" 
android:background="#aaffaa" 
android:gravity="center" 
android:text="world" 
android:textColor="#000000" 
android:textSize="1l7sp" /> 
</LinearLayout> 
</android.support .v4.widget.NestedScrollView> 
</android.support.design.widget.CoordinatorLayout> 


与 上 述 布局 文件 对 应 的 Kotlin 页 面 代码 如 下 所 示 : 


class AppbarNestedActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView (R.layout .activity appbar nested) 
setSupportActionBar (tl title) 


} 


应 用 栏 布局 配合 嵌 套 滚动 视图 的 演示 效果 如 图 7-20 一 图 7-22 所 示 , 其 中 图 7-20 展示 打开 演示 
页 的 初始 界面 ， 此 时 工具 栏 位 于 页 面 顶部 ， 图 7-21 展示 上 拉 一 小 段 时 的 界面 ， 此 时 工具 栏 随 着 向 
上 滚动 一 段 ; 图 7-22 展示 上 拉 一 大 段 时 的 界面 ， 此 时 工具 栏 滚动 到 屏幕 之 外 ， 完 全 看 不 见 了 。 
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complex 一 -一 - hello 


hello 





图 7-20 ”应 用 栏 搭配 嵌 套 深 动 视图 的 ”图 7-21 应 用 栏 上 拉 一 小 段 时 的 。 图 7-22 应 用 栏 上 拉 一 大 段 时 的 
初始 演示 界面 苞 套 滚动 视图 界面 苞 套 滚动 视图 界面 


7.2.4 ”可 折 又 工具 栏 布局 CollapsingToolbarLayout 


7.2.3 小 节 阅 述 了 如 何 把 Toolbar 往 上 滚动 ， 那 反 过 来 ， 能 不 能 把 Toolbar 往 下 拉动 呢 ? 这 里 要 
明确 一 点 ，Toolbar 本 身 是 页 面 顶部 的 工具 栏 ， 其 上 没有 当前 页 面 的 其 他 控件 。 假 如 Toolbar 拉 下 
来 ， 那 Toolbar 上 面 的 空白 该 显示 什么 呢 ? 所 以 Toolbar 的 上 部 边缘 是 不 可 以 往 下 拉 的 ， 只 有 下 部 
边缘 才能 往 下 拉 ， 这 样 的 视觉 效果 好 比 Toolbar 如 电影 幕布 一 般 组 组 向 下 展开 。 

不 过 ，Android 在 实现 导航 栏 展开 效果 的 时 候 ， 并 非 直接 让 Toolbar 展开 或 收缩 ， 而 是 另外 提 
供 了 可 折 对 工具 栏 布局 CollapsingToolbarLayout， 通 过 该 布局 节点 包 于 Toolbar 节点 ， 从 而 控制 导 
航 栏 的 展开 和 收缩 行为 。 

若 要 在 App 工程 中 使 用 CollapsingToolbarLayout， 则 需 注 意 以 下 几 点 修改 : 





(1) 在 build.gradle 中 添加 几 个 库 的 编译 支持 ,包括 appcompat-v7 库 (Toolbar 需要 ) 、design 
库 (CollapsingToolbarLayout 需要 ) 、recyclerview 库 〈 主 页 面 的 RecyclerView 需要 ) 。 

(2) 布局 文件 的 根 布局 采用 CoordinatorLayout， 因 为 design 库 的 动态 效果 都 依赖 于 该 控件 ， 
并 且 该 节点 要 添加 命名 空间 声明 xmlns:app="http://schemas.android.com/apk/res-auto"。 

(3) 使 用 AppBarLayout 节点 包 于 CollapsingToolbarLayout 节点 ,再 在 CollapsingToolbarLayout 
节点 下 添加 Toobar 节点 。 

(4) 给 Toobar 节点 添加 滚动 属性 app:layout_scrollFlags="scrolllenterAlways"， 声 明 工 具 栏 的 
滚动 行为 标志 。 

(5) 演示 界面 的 页 面 主体 使 用 RecyclerView 控件 或 者 NestedScrollView 控件 ， 并 给 该 控件 节 
点 添加 行为 属性 ， 即 app:layout behavior="@string/appbar_scrolling_view_behavior"， 表 示 通 知 
AppBarLayout 捕捉 RecyclerView 的 滚动 操作 。 

App 在 运行 的 时 候 ，Toolbar 的 高 度 是 固定 不 变 的 ， 会 发 生 高 度 变化 的 布局 其 实 是 
CollapsingToolbarLayout。 只 是 许多 App 把 这 两 者 的 背景 设 为 一 种 颜色 ， 所 以 看 起 来 像 是 统一 的 标 
题 栏 在 收缩 和 展开 。 既然 二 者 原本 不 是 一 家 ,那么 就 得 有 新 的 属性 用 于 区 分 它们 内 部 的 行为 , 新 属 
性 有 两 个 ， 分 别 说 明 如 下 : 

(1) 折 侠 模式 属性 。 属 性 名 为 app:layout_collapseMode， 它 指定 子 视图 (通常 是 Toolbar) 的 
折 秋 模式 ， 折 竺 模 式 的 取 值 说 明 见 表 7-2。 
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表 7-2 折叠 模式 的 取 值 说 明 
折 和 模式 取 值 | 说 明 
pin 固定 模式 。Toolbar 固定 不 动 ， 不 受 CollapsingToolbarLayonut 的 折 释 影响 
parallax 视差 模式 。 随 着 CollapsingToolbarLayout 的 收缩 与 展开 ，Toolbar 也 跟着 收缩 与 展开 。 折 大 系 
数 可 通过 属性 app:layout_ collapseParallaxMmultiplier 配置 ， 该 属性 为 1.0 时 ， 折 闭 效 果 同 pin 模 
式 ， 即 固定 不 动 :该 属性 为 0.0 时 ， 折 对 效果 等 同 于 none 模式 ， 即 也 跟着 移动 相同 距离 
none 默认 值 。CollapsingToolbarLayout 折 又 多 少 距离，Toolbar 也 随 着 移动 多 少 距离 ， 通 俗 地 说 ， 





就 是 夫 唱 妇 随 


(2) 折 秋 距离 系数 属性 。 属 性 名 为 app:layout_collapseParallaxMultiplier， 它 指定 视差 模式 时 
的 折 全 距离 系数 ， 取 值 在 0.0 一 1.0 之 间 。 车 不 明确 指定 ， 则 该 属性 值 默 认为 0.5。 


为 了 区 分 这 几 种 折叠 模 式 之 间 的 差异 ， 下 面 演示 一 个 pin 固定 模式 使 用 的 布局 文件 例子 : 


<android.support.design.widget.CoordinatorLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:app="http://schemas.android.com/apk/res-auto" 


android:id="@+id/cl main" 


android:layout width: 


atch parent" 





android:layout height="match parent" > 


<android.support .design.widget .AppBarLayout 
android:id="@+id/abl title" 
android:layout width="match parent" 
android:layout height="160dp" 
android:background="@color/blue light" > 


<android.support .design.widget.CollapsingToolbarLayout 


android:id="@+id/ctl title" 

android:layout width="match parent" 
android:layout height="match parent" 

app:layout scrollFlags="scroll|exitUntilCollapsed" 
app:contentScrim="?attr/colorPrimary" 
app:expandedTitleMarginstart="40dp" > 


<android.support.v7.widget.Toolbar 
android:id="@+id/tl title" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/red" 
app:layout_collapseMode="pin" /> 


</android.support.design.widget.CollapsingToolbarLayout> 


</android.support .design.widget.AppBarLayout> 


<android.support.v7.widget.RecyclerView 
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android:id="e@+id/rV main" 

android:layout width="match parent" 

android:layout height="match parent" 

app:layout behavior="@string/appbar scrolling view behavior" /> 
</android.support.design.widget.CoordinatorLayout> 


与 上 述 布局 文件 对 应 的 Kotlin 页 面 代 码 如 下 所 示 : 
class CollapsePinActivity : AppCompatActivity() { 


private val years = arrayOf(" 鼠 年 "，" 牛 年 "，" 虎 年 "，" 免 年 "，" 龙 年 "，" 蛇 年 "，" 
马 年 "，" 羊 年 "， " 猴 年 "， " 鸡 年 "，" 狗 年 "，" 猪 年 ") 


override fun onCreate (savedInstanceState: Bundle?) { 
Super.onCreate (savedInstanceState) 
setContentView(R.layout .activity collapse pin) 
tl1 title.setBackgroundColor (Color .RED) 
setSupportActionBar (tl] title) 
ctl title.title = getString(R.string.toolbar name) 
rv main.layoutManager = LinearLayoutManager (this) 
rv main.adapter = RecyclerCollapseAdapter (this, years) 


} 

采取 pin 固定 模式 的 导航 栏 变化 效果 如 图 7-23 一 图 7-25 所 示 ， 其 中 图 7-23 展示 刚 打 开 页 面 时 
的 初始 界面 ， 此 时 导航 栏 完全 展开 ;图 7-24 展示 往 上 拉动 一 小 段 之 后 的 界面 ， 此 时 导航 栏 下 半 部 
分 向 上 收缩 ， 标 题 文 字 随 之 上 移 ， 而 上 半 部 分 红色 的 Toolbar 保持 不 变 ; 图 7-25 展示 往 上 拉动 一 大 
段 之 后 的 界面 ， 此 时 导航 栏 下 半 部 分 完全 消失 ， 标 题 文 字 全 部 移入 上 半 部 分 红色 的 Toolbar。 














欢乐 中 国 年 





鼠 年 
和 年 
图 7-23 固定 模式 下 的 导航 栏 图 7-24 上 拉 一 小 段 时 的 图 7-25 上 拉 一 大 段 时 的 
初始 界面 导航 栏 界面 导航 栏 界 面 


接 下 来 继续 演示 parallax 视差 模式 ， 只 要 把 原 布局 文件 中 的 Toolbar 节点 替换 为 下 面 的 内 容 即 
可 ， 其 他 布局 与 Kotlin 代码 均 保 持 不 变 : 
<android.support.v7.widget.Toolbar 
android:id="@+id/tl1 title" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
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android:background="@color/red" 
app:layout collapseMode="parallax" 
app:layout collapseParallaxMultiplier="0.1" /> 


采取 parallax 视差 模式 的 导航 栏 变化 效果 如 图 7-26 一 图 7-28 所 示 ， 其 中 图 7-26 展示 刚 打开 页 
面 时 的 初始 界面 ， 此 时 导航 栏 完 全 展开 ;图 7-27 展示 往 上 拉动 一 小 段 之 后 的 界面 ， 此 时 导航 栏 下 
半 部 分 向 上 收缩 ， 标 题 文字 随 之 上 移 ， 且 上 半 部 分 红色 的 Toolbar 也 按照 比例 向 上 收缩 ; 图 7-28 
展示 往 上 拉动 一 大 段 之 后 的 界面 ,此 时 导航 栏 下 半 部 分 完全 消失 ,标题 文字 全 部 移入 顶部 ， 且 上 半 
部 分 红色 的 Toolbar 也 从 屏幕 上 消失 。 

注意 到 前 面 几 个 布局 文件 都 用 到 了 app:layout scrollFlags 属性 ， 并 且 有 时 候 取 值 为 
"scrolllenterAlways"， 有 时 候 取 值 为 "scrolllexitUntilCollapsed"， 这 是 为 什么 呢 ? 其 实 这 个 滚动 标志 
属性 来 自 于 AppBarLayout， 它 用 来 定义 下 级 控件 的 具体 滚动 行为 ， 比 如 先 滚 还 是 后 滚 、 滚 一 半 还 
是 全 部 滚 、 自 动 滚 还 是 手动 滚 等 。 








欢乐 中 国 年 
鼠 年 
牛 年 
图 7-26 视差 模式 下 的 导航 栏 图 7-27 上 拉 一 小 段 时 的 图 7-28 上 拉 一 大 段 时 的 
初始 界面 导航 栏 界面 导航 栏 界面 
首先 得 弄 清 楚 为 什么 AppBarLayout 划分 了 这 几 种 滚动 行为 ， 所 谓 知 其 然 还 要 知 其 所 以 然 ， 才 


更 有 利于 记忆 和 理解 。 下 面 是 可 能 产生 不 同 滚动 行为 的 几 种 场景 ; 


(1) AppBarLayonut 的 滚动 依赖 于 页 面 主体 的 滚动 ， 与 页 面 主体 相对 应 ， 可 将 AppBarLayout 
称 作 页 面 头 部 。 既 然 一 个 页 面 分 为 头 部 和 主体 两 部 分 ， 那 么 就 存在 谁 先 滚 谁 后 滚 的 问题 。 

(2) AppBarLayout 内 部 的 高 度 也 可 能 变化 ， 比 如 它 棋 套 了 可 折 受 工具 栏 布 局 
CollapsingToolbarLayout。 既 然 AppBarLayout 的 高 度 是 变化 的 ， 那 也 得 区 分 是 滚 一 半 还 是 滚 全 部 。 

(3) AppBarLayonut 被 拉动 了 一 段 还 没 拉 完 ， 此 时 一 旦 松 开 手指 ， 一 般 是 就 地 停 住 。 但 半路 刹 
车 有 碍 观瞻 ， 那 么 就 得 判断 是 继续 停 着 不 动 ， 还 是 继续 向 上 收缩 ， 或 者 继续 向 下 展开 。 






上 面 区 分 好 了 各 种 滚动 行为 的 起 因 与 目的 , 再 来 谈 谈 layout_scrollFlags 的 取 值 情况 ,这 个 滚动 
标志 的 取 值 说 明 见 表 7-3。 


表 7-3 ”滚动 标志 的 取 值 说 明 


滚动 标志 取 值 说 明 
scroll 头 部 与 主体 一 起 滚动 











头 部 与 主体 先 一 起 滚动 , 头 部 滚 到 位 后 , 主体 继续 向 上 或 者 向 下 滚 。 该 标志 需要 与 scroll 
同时 声明 


enterAlways 
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( 续 表 ) 

滚动 标志 取 值 说 明 

oy 该 标志 保证 页 面 上 至 少 能 看 到 最 小 化 的 工具 栏 ， 不 会 完全 看 不 到 工具 栏 。 该 标志 需要 
exitUntilCollapsed 

与 scroll 同时 声明 

A 该 标志 与 enterAlways 的 区 别 在 于 有 折 释 操作 ， 而 单独 的 enterAlways 没有 折 营 。 该 标 
TP | 志 需 要 与 scroll enterAlways 同时 声明 
i 在 用 户 手指 松 开 时 ， 系 统 自行 判断 ， 接 下 来 是 全 部 向 上 滚 到 项 ， 还 是 全 部 向 下 展开 。 
ee 该 标志 需要 与 scroll 同时 声明 





7.2.5” 仿 支付 宝 首 页 的 头 部 伸缩 特效 


前 面 几 个 小 节 介绍 了 与 顶部 导航 栏 相 关 的 几 个 布局 用 法 ， 可 要 是 在 实战 中 派 不 上 用 场 ， 又 有 
什么 用 ? 确实 ， 如 果 一 项 技术 没有 真正 用 起 来 ， 那 就 只 是 花 拳 绣 腿 而 已 。 但 是 协调 布局 等 控件 绝 非 
等 闲 之 辈 ， 既 然 它们 由 Android 在 MaterialDesign 库 中 隆重 推出 ， 肯 定 有 大 用 途 。 下 面 来 看 两 张 导 
航 栏 的 效果 图 ， 如 图 7-29 所 示 ， 这 是 某 App 导航 栏 完全 展开 时 的 界面 ， 此 时 页 面 头 部 的 导航 栏 占 
据 较 大 部 分 的 高 度 ; 如 图 7-30 所 示 ， 这 是 该 App 导航 栏 完 全 收缩 时 的 界面 ， 此 时 头 部 导航 栏 只 剩 
矮 矮 的 一 个 长 条 。 


U 山 


下 


| 付 一 付 





图 7-29 仿 支付 宝 首页 的 头 部 展开 效果 图 7-30 仿 支 付 宝 首页 的 头 部 缩 起 效果 


看 起 来 很 眼熟 是 不 是 ， 这 两 张 界面 截图 分 明 很 像 支付 宝 首页 的 头 部 效果 。 如 果 读 者 已 经 熟悉 
运用 AppBarLayout 和 CollapsingToolbarLayout， 也 许 很 快 便 可 以 做 出 类 似 以 上 效果 的 简单 界面 。 
概括 地 说 ， 就 是 定义 一 个 协调 布局 CoordinatorLayout， 然 后 嵌 套 应 用 栏 布局 AppBarLayout， 再 嵌 
套 可 折 全 工具 栏 布局 CollapsingToolbarLayout， 再 嵌 套 工具 栏 Toolbar 的 页 面 布局 。 支 付 宝 首页 之 
所 以 要 嵌 套 这 么 多 层 ， 是 因为 要 完成 以 下 功能 : 


(1) CoordinatorLayout 嵌 套 AppBarLayout， 这 是 为 了 让 头 部 导航 栏 能 够 跟随 视图 主体 下 拉 而 
展开 ， 并 且 跟 随 视 图 主体 上 拉 而 收缩 。 这 个 视图 主体 可 以 是 RecyclerView ， 也 可 以 是 
NestedScrollView。 

(2) AppBarLayout 嵌 套 CollapsingToolbarLayout， 这 是 为 了 定义 导航 栏 下 面 需要 展开 和 收缩 
的 这 部 分 视图 。 
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(3) CollapsingToolbarLayout 嵌 套 Toolbar， 这 是 为 了 声明 导航 栏 上 方 无 论 何 时 都 要 显示 的 长 
条 区 域 ， 其 中 Toolbar 还 要 定义 两 个 不 同 的 下 级 布局 ， 用 于 分 别 显示 展开 与 收缩 两 种 状态 时 的 工具 
栏 界 面 。 


下 面 是 基于 以 上 思路 实现 的 仿 支付 宝 首页 布局 文件 例子 : 


<android.support.design.widget.CoordinatorLayout xmlns:android= 





"http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent" 
android:fitsSystemWindows="true" > 


<android.support.design.widget.AppBarLayout 
android:id="@+id/abl bar" 
android:layout widt 





"match parent" 
android:layout height="wrap_content" 
android:fitsSystemWindows="true" > 


<android.support.design.widget.CollapsingToolbarLayout 
android:layout width="match Parent" 
android:layout height="match parent" 
android:fitsSystemWindows="true" 
app:layout_scrollFlags="scroll|lexitUntilCollapsed|snap" 
app:contentScrim="@color/blue dark" > 


<!-- 1ife_pay.xml 定义 了 工具 栏 下 方 的 频道 布局 --> 

<include 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:layout marginTop="@dimen/toolbar height" 
app:layout collapseMode="parallax" 
app:layout_collapseParallaxMultiplier="0.7" 
layout="@layout/life pay" /> 


<android.support.v7.widget.Toolbar 
android:layout width="match parent" 
android:layout height="@dimen/toolbar height" 
app:layout collapseMode="pin" 
app:contentInsetLeft="0dp" 
app:contentInsetStart="0dp" > 


<!-- toolbar_expand.xml 定义 了 展开 状态 时 的 工具 栏 内 容 布 局 --> 
<include 
android:id="@+id/tl] expand" 
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android:1ayout_ width="match parent" 
android:layout height="match Parent" 
layout="@layout/toolbar expand" /> 


<!-- toolbar_collapse.xml 定义 了 收缩 状态 时 的 工具 栏 内 容 布局 --> 
<include 
android:id="@+id/tl] collapse" 
android:layout width="match parent" 
android:layout height="match parent" 
layout="@layout/toolbar collapse" 
android:visibility="gone" /> 
</android.support.v7.widget.Toolbar> 
</android.support.design.widget.CollapsingToolbarLayout> 
</android.support.design.widget.AppBarLayout> 


<android.support.v7.widget.RecyclerView 
android:id="@+id/rv content" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout marginTop="10dp" 
app:layout behavior="@string/appbar_ scrolling view behavior" /> 
</android.support.design.widget.CoordinatorLayout> 


然而 仅 实现 上 述 布局 并 非 万 事 大 吉 ， 因 为 支付 宝 首页 的 头 部 在 伸缩 时 可 是 有 动画 效果 的 ， 就 
像 图 7-31 和 图 7-32 所 示 的 淡 入 淡出 渐变 动画 。 





图 7-31 头 部 导航 栏 的 淡 入 效果 图 7-32 头 部 导航 栏 的 淡出 效果 
图 7-31 和 图 7-32 所 体现 的 渐变 动画 其 实 可 分 为 两 部 分 : 


(1) 导航 栏 从 展开 状态 向 上 收缩 时 , 头 部 的 各 个 控件 要 慢 慢 向 背景 色 过 渡 , 也 就 是 淡 入 效果 。 

(2) 导航 栏 向 上 收缩 到 一 半 ， 顶 部 的 工具 栏 要 更 换 成 收缩 状态 下 的 工具 栏 布局 ， 并 且 随 着 导 
航 栏 继续 向 上 收缩 ， 新 工具 栏 上 的 各 个 控件 也 要 慢 慢 变 得 清晰 起 来 ， 也 就 是 淡出 效果 。 

若 导 航 栏 是 从 收缩 状态 向 下 展开 的 ， 则 此 时 相应 地 做 上 述 渐 变动 画 的 取 反 效果 ， 即 下 面 的 
描述 : 
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(1) 导航 栏 从 收缩 状态 向 下 展开 时 , 头 部 的 各 个 控件 要 慢 慢 向 背景 色 过 渡 , 也 就 是 淡 入 效果 ; 
同时 展开 导航 栏 的 下 部 分 布局 ， 并 且 该 布局 上 的 各 个 控件 渐渐 变 得 清晰 。 

(2) 导航 栏 向 下 展开 到 一 半 ， 顶 部 的 工具 栏 要 更 换 成 展开 状态 下 的 工具 栏 布局 ， 并 且 随 着 导 
航 栏 继 续 向 下 展开 ， 新 工具 栏 上 的 各 个 控件 也 要 慢 慢 变 得 清晰 起 来 ， 也 就 是 淡出 效果 。 


看 文字 描述 还 比较 复杂 ， 如 果 只 对 某 个 控件 做 渐变 动画 还 好 ， 可 是 导航 栏 上 的 控件 有 好 几 个 ， 
而 且 数量 并 不 国定 , 常常 会 增加 新 控件 或 者 修改 原 控 件 。 倘 若 要 对 导航 栏 上 的 各 个 控件 逐一 展示 动 
画 ， 不 但 花费 力气 ， 而 且 后 期 也 不 好 维护 。 为 了 解决 这 个 动画 问题 ， 可 以 采取 类 似 遮 单 的 做 法 ， 即 
一 开始 先 给 导航 栏 单 上 一 层 透明 的 视图 , 此 时 导航 栏 的 界面 就 完全 显示 ; 然后 随 着 导航 栏 的 移动 距 
离 计 算 当前 位 置 下 的 遮 章 透明度, 使 该 遮 单 变 得 越 来 越 不 透明 , 看 起 来 导航 栏 像 是 蒙 上 了 一 层 注 雾 
面纱 ， 蒙 到 最 后 就 完全 看 不 见 了 。 反 过 来 ， 也 可 以 一 开始 给 导航 栏 界 上 一 层 不 透明 的 视图 ， 此 时 导 
航 栏 的 所 有 控件 都 是 看 不 见 的 , 然后 随 着 距离 的 变化 ， 谈 日 变 得 越 来 越 不 透明 ,导航 栏 也 会 跟着 变 
得 越 来 越 清 晰 。 

现在 渐变 动画 的 思路 有 了 ， 可 谓 万 事 俱 备 ， 只 从 东风 ， 再 注册 一 个 导航 栏 的 位 置 偏 移 监听 事 
件 便 行 ， 正 好 有 个 现成 的 监听 器 AppBarLayout.OnOffsetChangedListener， 只 需 给 应 用 栏 布局 对 象 
调用 addOnOffsetChangedListener 方法 ， 即 可 实现 给 导航 栏 注册 偏 移 监听 器 的 功能 。 接 下 来 看 下 面 
具体 的 Kotlin 实现 代码 : 

// 因 为 布局 文件 通过 include 加 载 了 多 个 子 布局 , 所 以 Kotlin 代码 也 要 同时 import 导入 所 有 相关 
的 布局 


import kotlinx.android.synthetic.main.activity scroll alipay.* 





import kotlinx.android.synthetic.main.life pay.* 
import kotlinx.android.synthetic.main.toolbar expand.* 
import kotlinx.android.synthetic.main.toolbar collapse.* 


class ScrollAlipayActivity : AppCompatActivity(), OnOffsetChangedListener { 
Private var mMaskColor: Int = 0 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView (R.layout .activity scroll alipay) 
mMaskColor = resources.getColor(R.color.blue dark) 
// 给 控件 abl_bar 注册 一 个 位 置 偏 移 的 监听 器 
abl bar.addonOffsetChangedListener (this) 
rv_content.layoutManager = GridLayoutManager (this, 4) 
// 第 一 种 方式 :使 用 采取 了 LayoutContainer 的 适配器 
//rv_content.adapter = RecyclerLifeAdapter (this, LifeItem.default) 
// 第 二 种 方式 : 使 用 把 三 类 可 变 要 素 抽象 出 来 的 适配器 
rv_content.adapter = RecyclerCommonAdapter (this, R.layout.item life, 
LifeItem.default， 
{ view, item -> 
val iv pic = view.findViewById<ImageView> (R.id.iv pic) 
val tv title = view.findViewById<TextView>(R.id.tv title) 
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iv pic.setImageResource (item.pic id) 
tv title.text = item.title 
}) 


override fun onOffsetChanged (appBarLayout: AppBarLayout, verticalOffset: 
LAC) £ 
val offset = Math.abs (verticalOffset) 
val total = appBarLayout.totalScrollRange 
val alphaOut = if (200 - offset < 0) 0 else 200 - offset 
// 计 算 淡 入 时 候 的 遮 单 透明度 
val maskColorIn = Color.argb (offset，Color.red(mMaskColor) 
Color.green (mMaskColor), Color.blue (mMaskColor)) 
// 工 具 栏 下 方 的 频道 布局 要 加 速 淡 入 或 者 淡出 
val maskColorInDouble = Color.argb (offset * 2, Color.red (mMaskColor), 
Color.green (mMaskColor), Color.blue (mMaskColor)) 
// 计 算 淡出 时 候 的 遮 单 透明 度 
val maskColorOut = Color.argb (alphao0ut * 3，Color.red(mMaskColor)， 
Color .green (mMaskColor), Color.blue (mMaskColor)) 
if (offset <= total / 2) { // 若 偏 移 量 小 于 一 半 ， 则 显示 展开 时 候 的 工具 栏 
tl_ expand.visibility = View.VISIBLE 
tl _collapse.visibility = View.GONE 





V_expand mask.setBackgroundColor (maskColorInDouble) 
} else { // 若 偏 移 量 大 于 一 半 ， 则 显示 缩小 时 候 的 工具 栏 

tl expand.visibility = View.GONE 

tl collapse.visibility = View.VISIBLE 

V_collapse mask.setBackgroundColor (maskColorOut) 
} 
V pay_ mask.setBackgroundColor (maskColorIn) 


} 


本 节 人 至 此 基本 过 了 一 遍 MaterialDesign 库 的 主要 控件 用 法 , 虽然 没 涉及 什么 新 的 Kotlin 语法 知 
识 ， 但 是 复习 现 有 的 语法 也 不 错 ， 温 故而 知 新 ， 慢 慢 来 。 


7.3 ”实现 页 面 切换 


前 两 节 介 绍 的 视图 排列 和 协调 布局 基本 上 属于 上 下 滚动 ， 再 深入 也 只 是 让 上 下 滚动 的 花样 变 
得 丰富 一 些 。 可 是 许多 App 除了 上 下 滚动 操作 外 ， 还 有 左右 滑动 的 页 面 切换 操作 ， 那 么 页 面 的 左 
右 滑动 又 是 怎样 实现 的 呢 ? 本 节 就 对 页 面 的 左右 滑动 展开 说 明 , 从 翻 页 视图 到 碎片 适 配 再 到 标签 布 
局 ， 逐 步 介绍 页 面 切换 的 几 种 实现 方式 。 
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7.3.1 ” 翻 页 视图 ViewPager 


由 于 手机 屏幕 是 竖 长 形状 的 ， 高 度 比 宽度 大 ， 因 此 页 面 在 多 数 情况 下 是 上 下 滚动 的 。 然 而 上 
下 滚动 仅 限 于 一 维 方向 ,无 法 有 效 利 用 屏幕 空间 ， 所 以 往往 还 需要 支持 左右 滑动 , 通过 手势 的 左 滑 
或 者 右 滑 来 模拟 现实 生活 中 的 翻 页 效果 ， 于 是 便 有 了 翻 页 视图 ViewPager。 

对 于 翻 页 视图 来 说 ， 一 个 页 面 就 是 一 个 单项 (相当 于 ListView 的 一 个 列表 项 ) ， 许 多 个 页 面 
组 成 ViewPager 的 页 面 项 。 已 经 明确 了 ViewPager 的 原理 类 似 ListView 和 GridView，ViewPager 
的 用 法 也 与 它们 类 似 。 列 表 视 图 和 网 格 视图 的 适配器 使 用 基本 适配器 BaseAdapter， 翻 页 视图 的 适 
配器 则 用 翻 页 适配器 PagerAdapter; 列表 视图 和 网 格 视图 的 监听 器 使 用 OnItemClickListener， 翻 页 
视图 的 监听 器 则 用 OnPageChangeListener， 表 示 监 听 页 面 切 换 事件 。 表 7-4 给 出 了 翻 页 视图 相关 方 
法 /属性 的 Kotlin 与 Java 方法 调用 方式 的 对 比 关 系 。 

表 7-4 翻 页 视图 相关 方法 /属性 的 Kotlin 与 Java 方法 调用 方式 对 比 
方法 /属性 说 明 Kotlin 的 调用 方式 Java 的 调用 方式 
设置 页 面 项 的 适配器 adapter setAdapter 
设置 当前 的 页 码 currentItem setCurrentItem 


设置 翻 页 视图 的 页 面 切换 监听 器 addOnPageChangeListener 


翻 页 适配器 PagerAdapter 与 基本 适配器 BaseAdapter 的 用 法 相近 ， 也 需 实现 构造 函数 ， 获 取 页 
面 个 数 的 getCount 方法 ， 生 成 单个 页 面 视图 的 instantiateItem 方法 ， 另 外 多 了 一 个 回收 页 面 的 
destroyltem 方法 。 举 个 左右 翻动 手机 图 片 进行 浏览 的 例子 ， 每 个 页 面 都 是 单独 的 图 像 视图 
ImageView， 所 有 图 像 页 面 通过 翻 页 适配器 组 合 到 翻 页 视图 之 中 。 下 面 是 使 用 PagerAdapter 实现 浏 
览 图 片 效果 的 Kotlin 代码 示例 : 

// 在 主 构造 函数 中 声明 与 入 参 同名 的 属性 及 其 初始 赋值 操作 

class ImagePagerAdapater (private val context: Context, private val goodsList: 
MutableList<GoodsInfo>) : PagerAdapter() { 

Private val views = mutableListOf<ImageView>() 


// 初 始 化 函数 进行 开发 者 额外 的 初始 操作 


init { 























for (item in goodsList) { 
Val view = ImageView (context) 
view.layoutParams = LayoutParams (LayoutParams .MATCH PARENT, 
LayoutParams .WRAP CONTENT) 
View.setImageResource (item.pic) 
view.scaleType = ScaleType.FIT CENTER 
views.add (view) 


} 
// 获 取 页 面 数量 ， 使 用 了 简化 函数 


argl) 
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override fun getCount(): Int = views.size 


// 判 断 指定 页 面 是 否 已 加 入 适配器 ， 注 意 这 里 用 到 了 引用 相等 


override fun isViewFromObject (arg0: View, argl: Any): Boolean = (arg0 === 


// 回 收 页 面 


Override fun destroyItem(container: ViewGroup, position: Int, ‘object’: Any) { 
container.removeView (views [position]) 

1 

// 实 例 化 每 个 页 面 

override fun instantiateItem(container: ViewGroup, position: Int): Any { 
container.addView (views [position]) 
return views[position] 

} 

// 获 得 页 面 的 标题 ， 要 跟 PagerTabstrip 配合 使 用 


override fun getPageTitle (Position: Int): CharSequence = 


goodsList [position] .name 


} 


与 上 面 适配器 对 应 的 Kotlin 页 面 代码 如 下 所 示 : 


class ViewPagerActivity : AppCompatActivity(), OnPageChangeListener { 


} 


Private var goodsList = GoodsInfo.defaultList 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout .activity view pager) 
// 注 意 PagerTabStrip 不 存在 textSize 属性 ， 只 能 调用 setTextSize 方法 设置 文字 大 小 
pts_ tab.setTextSize (TypedValue.COMPLEX UNIT SP, 20f) 
pts_tab.setTextColor (Color .GREEN) 
VP_content .adapter = ImagePagerAdapater (this, goodsList) 
VP_content .currentItem = 0 
vp_content .addOonPageChangeListener (this) 

. 


override fun onPageScrollStateChanged(arg0: Int) {} 
override fun onPageScrolled(arg0: Int, argl: Float, arg2: Int) {} 


// 在 页 面 切 换 结束 〈 即 滑动 停止 》 时 触发 该 方法 
override fun onPageSelected(arg0: Int) { 
toast ("您 翻 到 的 手机 品牌 是 : ${goodsList[arg0] .name}") 


从 以 上 代码 看 到 ,使 用 Kotlin 书写 的 页 面 代 码 稀 松 平常 , 倒是 翻 页 适配器 ImagePagerAdapater 
的 Kotlin 实现 代码 大 有 讲究 ， 主 要 有 以 下 几 个 要 点 : 
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(1) 主 构造 函数 只 能 自动 完成 与 入 参 同名 的 属性 声明 及 其 初始 赋值 操作 ， 如 果 还 存在 其 他 初 
始 化 操作 ， 就 需要 在 init 函数 中 完成 。 

(2) isViewFromObject 方法 判断 指定 页 面 是 否 已 加 入 
适配器 ， 因 为 是 判断 唯一 性 ， 所 以 为 了 防止 盗版 ， 必 须 通过 
引用 相等 来 校 验 。 

( 3) getPageTitle 方法 必须 配合 翻 页 标签 栏 
PagerTabStrip 或 者 翻 页 标题 栏 PagerTitleStrip 控件 才能 正常 
显示 页 面 上 方 的 标题 文字 。 

由 此 可 见 , 翻 页 适配器 Kotlin 代码 的 关键 之 处 是 引用 相 
等 。 分 析 代码 完毕 ， 接 着 观察 一 下 翻 页 视图 的 滚动 效果 , 如 | 一 三 一 
图 7-33 所 示 , 在 截图 的 瞬间 ，ViewPager 正巧 在 左右 两 个 页 - 
面 之 问 滑动 。 图 7-33 ” 翻 页 视图 的 滚动 瞬间 界面 

















7.3.2 碎片 Fragment 


顾名思义 ， 碎 片 Fragment 只 是 页 面 的 片段 ， 并 非 完 整 的 页 面 ， 故 而 Fragment 很 少 单独 使 用 ， 
基本 都 要 跟 其 他 控件 配合 。 最 经 常 跟 Fragment 搭档 的 好 伙伴 自然 是 ViewPager， 不 过 普通 的 翻 页 
适配器 PagerAdapter 没 法 满足 Fragment， 必 须 搭配 Fragment 的 好 基 友 碎片 适配器 
FragmentStatePagerAdapter 才 行 。 

接 下 来 ， 使 用 Kotlin 编码 将 ViewPager+Fragment 的 翻 页 全 流程 实现 出 来 ， 首 先 要 定义 每 个 页 
面 的 动态 碎片 ， 依 旧 以 手机 商品 为 例 ， 演 示 用 的 Kotlin 碎片 类 代码 如 下 : 





class DynamicFragment : Fragment() { 
Private var ctx: Context? = null 
Private var mPosition: Int = 0 
Private var mImageId: Int = 0 
Private var mDesc: String? = null 
Private var mPrice: Int = 0 


override fun onCreateView (inflater: LayoutInflater, container: ViewGroup?, 
SavedInstanceState: Bundle?): View { 
ctx = activity 
// 碎 片 内 部 通过 arguments 获取 外 部 的 输入 参数 
if (arguments != null) { 
mPosition = arguments!!.getInt ("position", 0) 
mImageId = arguments!!.getInt ("image id", 0) 
mDesc = arguments!!.getSstring ("desc") 
mPrice = arguments!! .getInt ("price") 
} 
val view = inflater.inflate(R.layout.fragment dynamic, container, 
false) 
// 注 意 Fragment 内 部 仍 需 通过 findViewById 获得 控件 对 象 
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val iv pic = view.findViewById<ImageView> (R.id.iv pic) 
Val tv desc = view.findViewById<TextView> (R.id.tv_desc) 
iv pic.setImageResource (mImageId) 

tv_desc.text = "$mDesc\n 售 价 : $mPrice" 

return view 


有 


companion object { 
// 利 用 伴生 对 象 定义 获取 碎片 实例 的 静态 方法 
fun newInstance (position: Int, image id: Int, desc: String, price: Int): 
DynamicFragment { 

val fragment = DynamicFragment () 
val bundle = Bundle() 
bundle.putInt ("position", position) 
bundle.putInt ("image id", image id) 
bundle.putstring ("desc", desc) 
bundle.putInt ("price", price) 
// 外 部 通过 arguments 向 碎片 传递 输入 参数 
fragment .arguments = bundle 
return fragment 


j 
正如 上 面 代码 中 注释 描述 的 那样 ， 使 用 Kotlin 书写 碎片 类 主要 有 三 个 需要 注意 的 地 方 : 


(1) 在 Fragment 类 中 获取 控件 对 象 依然 要 调用 findViewById 方法 。 对 比 之 下 ，Activity 类 中 
早已 支持 直接 操作 控件 对 象 ， 即 使 是 循环 视图 的 适配器 ， 也 能 通过 插件 LayoutContainer 来 自动 获得 
控件 对 象 。 可 是 经 常用 到 的 Fragment 类 尚未 得 到 优化 ， 只 能 期 待 将 来 Kotlin 补充 这 方面 的 支持 了 。 

(2) 碎片 类 采用 Java 编码 时 ， 通 常会 提供 一 个 静态 方法 newInstance， 提 供给 外 部 以 获取 该 
碎片 的 实例 。 而 在 Kotlin 中 ， 若 要 实现 静态 方法 ， 则 需 借助 于 伴生 对 象 。 

(3) 外 部 向 碎片 传递 信息 ， 数 据 中 转 站 是 Fragment 对 象 的 情景 参数 arguments 属性 ， 而 非 
Activity 之 间 传 递 信息 用 到 的 intent 属性 。 其 实 arguments 与 intent 的 功能 类 似 ， 都 是 用 于 组 件 之 间 
传递 消息 ， 只 是 前 者 为 Activity 向 Fragment 传 数据 ， 而 后 者 为 Activity 向 另 一 个 Activity 传 数据 。 


分 析 完 了 碎片 类 的 Kotlin 实现 代码 ， 再 来 看 看 手机 商品 例子 的 碎片 适配器 ， 具 体 的 Kotlin 代 
码 如 下 所 示 : 





class MobilePagerAdapter (fm: FragmentManager, private val goodsList: 
MutableList<GoodsInfo>) : FragmentStatePagerAdapter(fm) { 


// 获 取 页 面 的 数量 


override fun getCount () : Int = goodsList.size 


// 获 取 每 个 页 面 的 碎片 对 象 
override fun getItem(Position: Int): Fragment { 
val item = goodsList[position] 
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return DynamicFragment .newInstance (position, item.pic, item.desc, 
item.price) 


} 


// 获 取 页 面 的 标题 
override fun getPageTitle(position: Int): CharSequence = 
goodsList[position] .name 
} 


可 见 上 述 的 碎片 适配器 代码 实在 精简 ， 比 起 对 应 的 Java 代码 来 又 瘦身 了 不 少 。 特 别 注意 ， 碎 
片 适配器 定义 了 一 个 FragmentManager 对 象 的 输入 参数 , 该 入 参 需 要 由 Activity 页 面 在 调用 时 填写 ， 
下 面 是 详细 的 Kotlin 页 面 代码 : 


class FragmentDynamicActivity : FragmentActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 

super.onCreate (savedInstanceState) 

setContentView(R.layout .activity fragment dynamic) 

pts_ tab.setTextSize (TypedValue.COMPLEX UNIT SP, 20f) 

// 碎 片 适配器 需要 传 入 碎片 管理 器 对 象 supportFragmentManager 

VP_content .adapter = MobilePagerAdapter (supportFragmentManager, 
GoodsInfo.defaultList) 

VP_content .currentItem = 0 


} 


依 例 再 看 看 碎片 结合 翻 页 视图 的 展示 效果 ， 如 图 7-34 所 示 ， 此 时 向 右 翻 到 华为 手机 的 界面 ; 
如 图 7-35 所 示 ， 此 时 继续 向 右 翻 到 OPPO 手机 的 界面 。 


2hone8 Mate10 小 米 6 OPPO R11 Vivo 》 








华为 HUAWEI Mate10 6GB+128GB 全 网 OPPO R11 4G+64G 全 网 通 4G 智 能 手机 玫 
通 (香槟 金 ) 现金 
售 价 : 3999 售 价 : 2899 











图 7-34 ” 翻 到 华为 手机 的 翻 页 视图 界面 图 7-35 翻 到 OPPO 手机 的 翻 页 视图 界面 
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7.3.3 ”标签 布局 TabLayout 


前 面 两 个 小 节 介绍 了 翻 页 视图 的 两 种 使 用 方式 : 普通 视图 
与 碎片 布局 ， 不 知 读者 有 没有 注意 到 ， 这 两 种 方式 呈现 出 来 的 
界面 效果 ， 在 视图 主体 上 方 会 有 两 排 控 件 。 如 图 7-36 所 示 ， 最 
上 面 一 排 为 系统 自 带 的 导航 栏 ， 导 航 栏 下 面 一 排 为 ViewPager 
的 标题 搭档 PagerTabStrip。 

然而 手机 屏幕 的 空间 本 来 就 有 限 ， 现 在 却 有 两 排 都 属于 导 
航 功能 的 控件 ， 实 在 是 挥霍 宝贵 的 显示 区 域 。 既 然 这 两 排 同样 
具备 导航 功能 ， 不 如 就 此 将 它们 合 二 为 一 ， 形 成 统一 的 顶部 导 
航 ， 如 此 岂 不 更 好 ? 这 个 思路 提 到 的 顶部 导航 栏 正 可 以 使 用 上 
一 节 提 到 的 工具 栏 Toolbar， 通 过 Toolbar 定制 开发 者 想 要 的 导 
航 栏目 。 至 于 PagerTabStrip 所 展现 的 文本 标签 切换 ， 则 可 利用 
MaterialDesign 库 里 的 新 控件 一 一 标签 布局 TabLayout， 把 标签 | 
布局 结合 翻 页 视图 使 用 ， 就 能 在 视觉 上 再 现 ViewPager 加 ”图 ”36 同时 存在 导航 栏 和 标签 页 的 
PagerTabStrip 的 翻 页 标签 切换 效果 。 翻 责 视图 界面 

因为 标签 布局 TabLayout 来 自 于 MaterialDesign 库 ， 所 以 使 用 该 控件 前 要 先 修改 build.gradle， 
在 dependencies 节点 中 加 入 下 面 一 行 表示 导入 design 库 : 

// 需 要 将 “$supportVersion” 替 换 为 读者 电脑 上 的 design 库 版 本 号 


compile 'com.android.support:design:$supportVersion' 
标签 布局 的 展现 形式 类 似 PagerTabStrip， 一 样 是 文字 标签 带 下 划 线 。 二 者 之 间 不 同 的 是 ， 
TabLayout 允许 定制 更 丰富 的 样式 ， 它 新 增 的 样式 属性 主要 有 以 下 几 种 。 
tabBackground: 指定 标签 的 背景 。 
tabIndicatorColor: 指定 下 划 线 的 颜色 。 
tabIndicatorHeight: 指定 下 划 线 的 高 度 。 
tabTextColor: 指定 标签 文字 的 颜色 。 
tabTextAppearance: 指定 标签 文字 的 风格 。 
tabSelectedTextColor: 指定 选中 文字 的 颜色 。 
在 代码 中 ，TabLayout 通过 如 下 方法 操作 标签 元 素 。 
newTab: 创建 新 标签 。 
addTab: 添加 一 个 标签 。 
getTabAt: 获取 指定 位 置 的 标签 。 
setOnTabSelectedListener: 设置 标签 的 选中 监听 器 。 


complex 




















接 下 来 要 实现 统一 的 顶部 导航 栏 ， 得 在 布局 文件 中 由 Toolbar 节点 包 豪 TabLayout 节点 ,表示 
在 工具 栏 框架 中 添加 标签 布局 控件 。 具 体 的 布局 文件 例子 如 下 所 示 : 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas .android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<android.support.v7.widget.Toolbar 
="@+id/tl head" 

android:layout width="match parent" 
android:layout height="50dp" 
app:navigationIcon="@drawable/ic back" > 





android:i 


<RelativeLayout 
android:layout width="match parent" 
android:layout height="wrap content" > 


<android.support.design.widget.TabLayout 
android:id="@+id/tab title" 
android:layout widt 





wrap_content™" 
android:layout height="match parent" 
android:layout centerInParent="true" 
app:tabIndicatorColor="@color/red" 
app:tabIndicatorHeight="2dp" 
app:tabSelectedTextColor="@color/red" 
app:tabTextColor="@color/grey" 
app:tabTextAppearance="@style/TabText" /> 


</RelativeLayout> 
</android.support .v7.widget.Toolbar> 


<!-- 这 是 一 条 项 部 导航 栏 与 页 面 主体 的 分 隔 线 --> 
<View 
android:layout width="match parent" 
android:layout height="1ldp" 
android:background="@color/grey" /> 


<android.support .v4.view.ViewPager 
android:id="@+id/vp_content" 
android:layout width="match Parent" 
android:layout height="match parent" /> 
</LinearLayout> 


那么 与 上 面 布局 文件 对 应 的 Kotlin 代码 需要 把 翻 页 视图 与 标签 布局 二 者 关联 起 来 。 关 联 的 方 
式 是 通过 监听 器 联动 ， 翻 页 视图 利用 页 面 切换 监听 器 SimpleOnPageChangeListener 去 同步 标签 布 
局 , 而 标签 布局 利用 标签 选中 监听 器 OnTabSelectedListener 去 同步 翻 页 视图 。 下 面 是 商品 翻 页 信息 
的 Kotlin 页 面 代码 例子 : 
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class TabLayoutActivity : AppCompatActivity(), OnTabSelectedListener { 
private val titles = mutableListOf<String> ("商品 "，" 详 情 ") 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity tab layout) 
// 使 用 自 定义 的 工具 栏 替换 系统 默认 的 导航 栏 
setSupportActionBar (tl head) 
initTabLayout () 
initTabViewPager () 


// 初 始 化 头 部 的 文本 标签 

Private fun initTabLayout () { 
tab _ title.addTab (tab title.newTab () .setText (titles[0])) 
tab title.addTab (tab title.newTab () .setText (titles[1])) 
tab title.addonTabSelectedListener (this) 


// 初 始 化 页 面 主体 的 翻 页 视图 
Private fun initTabViewPager () { 


VP_content .adapter = GoodsPagerAdapter (supportFragmentManager, 
titles) 
// 利 用 object 关键 字 表示 声明 一 个 匿名 实例 
VP_content .addOnPageChangeListener (object : 
SimpleOnPageChangeListener() { 
override fun onPageSelected (Position: Int) { 
// 翻 页 操作 停止 后 ， 同 步 切换 到 对 应 的 文本 标签 
tab title.getTabAt (Position)!!.select() 


override fun onTabReselected(tab: Tab) {} 


// 文 本 标签 选中 后 ， 同 步 切换 到 对 应 的 翻 页 页 面 
override fun onTabSelected (tab: Tab) { 
VP_content .currentItem = tab.position 


override fun onTabUnselected (tab: Tab) {} 
翻 页 视图 内 部 还 需 通过 碎片 适配器 加 载 具 体 的 每 个 碎片 页 面 ， 以 下 是 对 应 的 Kotlin 碎片 适 配 
器 代码 ， 仅 简单 加 载 了 两 个 碎片 页 BookCoverFragment 和 BookDetailFragment: 
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class GoodsPagerAdapter (fm: FragmentManager, private val titles: 
MutableList<String>) : FragmentPagerAdapter(fm) { 


// 根 据 位 置 序号 分 别 指定 不 同 的 Fragment 碎片 类 


override fun getItem(Position: Int): Fragment = when (Position) { 
0 -> BookCoverFragment () 


1 -> BookDetailFragment () 


else -> BookCoverFragment () 


override fun getCount(): Int = titles.size 


} 


override fun getPageTitle (position: Int): CharSequence = titles[position] 


最 终 运行 之 后 ,展现 了 位 于 统一 导航 栏 之 下 的 翻 页 视图 , 它 的 翻 页 切换 效果 如 图 7-37 和 图 7-38 


所 示 。 其 中 , 图 7-37 所 示 为 展示 “商品 ”标签 页 时 的 界面 此 时 导航 栏 提示 当前 为 商品 页 ; 图 7-38 
所 示 为 展示 “详情 ”标签 页 时 的 界面 ， 此 时 导航 栏 提示 当前 为 详情 页 。 





Android Studio ao 
从 零 丰 轴 到 ApP 上 线 


We 








Android Studio 开 发 实战 Android Studio 开 发 实战 
从 零 基础 到 App 上 线 从 零 基础 到 App 上 线 
7-37 展示 “商品 ”标签 页 的 界面 


图 7-38 展示 “详情 ”标签 页 的 界面 


7.4 广播 收发 Broadcast 


一 个 应 用 的 功能 越 强大 ， 它 所 包含 的 组 件 和 控件 的 数量 就 越 多 ， 不 断 增长 的 组 件 /控件 之 问 要 
想 进行 有 效 的 数据 传输 ， 有 赖 于 一 种 更 灵活 、 更 方便 的 消息 通信 机 制 。 在 Android 系统 中 ， 有 一 种 
灵活 通信 的 消息 机 制 被 塑造 成 四 大 组 件 之 一 的 广播 Broadcast。 本 节 就 对 广播 的 场景 、 过 程 、 实 现 
方式 等 概念 以 及 具体 用 法 进行 详细 的 说 明 介 绍 。 
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7.4.1 收发 临时 广播 


App 在 运行 过 程 中 ， 各 组 件 之 间 常 常 要 进行 数据 交互 ， 常 见 的 数据 交互 场景 主要 有 以 下 几 种 : 

(1) 一 个 页 面 Acitivity 向 另 一 个 页 面 Acitivity 传递 消息 ， 按 照 第 6 章 的 “6.4 Activity 活动 跳 
转 ” 一 节 的 描述 ， 可 使 用 Intent 对 象 传输 请 求 信息 。 对 应 地 ， 下 一 个 页 面向 上 一 个 页 面 返回 消息 也 
可 利用 Intent 对 象 传输 应 答 信息 。 

(2) 页 面 Acitivity 向 各 类 适配器 传递 消息 可 通过 适配器 的 主 构造 函数 传 入 参数 。 反 过 来 ， 适 
配器 向 页 面 Acitivity 返回 消息 则 稍微 有 些 麻 烦 ， 这 时 要 先 定义 一 个 监听 器 ， 由 Acitivity 向 适配器 
传 入 监听 器 对 象 ， 然 后 适配器 在 合适 的 时 候 调用 监听 器 的 方法 〈Activity 要 事先 实现 该 监听 器 的 内 
部 方法 ) ， 从 而 间接 实现 适配器 回调 页 面 的 要 求 。 

(3) 页 面 Acitivity 向 碎片 Fragment 传递 消息 时 ， 按 照 前 面 “7.3.2 碎片 Fragment” 小 节 的 叙 
述 ， 可 在 碎片 适配器 中 给 碎片 对 象 设置 情景 参数 arguments 属性 ， 然 后 碎片 内 部 从 arguments 中 获 
取 具 体 的 请 求 信息 。 但 若是 碎片 向 页 面 回 传 消息 ， 这 个 麻烦 就 大 了 ， 因 为 此 时 既 没 有 Activity 之 间 
的 ForResult 方法 ， 也 没 法 传 入 监听 器 对 象 ， 那 么 碎片 如 何 把 消息 传 回 给 页 面 ? 

像 上 面 的 第 三 种 数据 交互 情景 ，Android 中 还 有 好 些 类 似 的 无 法 直接 传递 数据 的 情况 ， 这 时 候 
便 用 到 了 广播 Broadcast 组 件 。 广 播 如 其 名 ， 它 发 送 消息 时 ， 并 未 指明 要 发 给 哪个 特定 对 象 ， 而 是 
面向 大 众 广 而 播 之 ,故而 台 下 的 听众 只 要 有 在 倾听 皆 可 接收 到 广播 内 容 。 由 此 看 来 , 广播 特别 适用 
于 Android 组 件 之 间 的 灵活 通信 ， 它 与 Activity 的 区 别 在 于 下 列 几 点 : 

(1) Activity 只 能 一 对 一 地 通信 ， 而 Broadcast 可 以 一 对 多 ， 一 人 发 送 广播 ， 多 人 接收 处 理 。 

(2) 对 于 发 送 者 来 说 ， 广 播 不 需要 考虑 接收 者 有 没有 在 工作 ， 接 收 者 有 在 工作 则 接收 广播 ， 
不 在 工作 则 丢弃 广播 。 

(3) 对 于 接收 者 来 说 ， 会 收 到 各 式 各 样 的 广播 ， 所 以 接收 者 首先 要 自行 过 滤 哪 些 是 符合 条 件 
的 ， 然 后 才能 进行 解 包 处 理 。 

与 广播 有 关 的 方法 主要 有 以 下 三 个 。 

@ sendBroadcast: 发 送 广播 。 

@ registerReceiver: 注册 广播 接收 器 。 接 收 器 只 有 在 注册 之 后 ， 才 能 正常 接收 广播 消息 。 

@ unregisterReceiver: 注销 广播 接收 器 。 


为 了 更 好 地 说 明 广播 的 工作 流程 ， 接 下 来 还 是 对 其 进行 具体 的 演示 。 和 壁 如 ，Fragment 内 部 有 
个 下 拉 框 ， 可 下 拉 选 择 背 景 颜色 ， 一 旦 选中 某 个 背景 色 ， 则 整个 活动 页 面 的 背景 色 都 换 成 新 颜色 。 
那么 Fragment 内 部 发 现 选中 新 颜色 后 ， 就 要 发 送 一 个 背景 色 变更 的 广播 。 下 面 是 Fragment 内 部 实 
现 广播 发 送 的 Kotlin 关键 代码 片段 : 

private val colorNames = listOof(" 红 色 "，" 黄 色 "，" 绿 色 "，" 青 色 "，" 蓝 色 ") 
Private val colorIds = intArrayOf (Color.RED，Color.YELLONW，Color.GREEN， 
Color.CYAN, Color.BLUE) 
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// 初 始 化 选择 背景 色 的 下 拉 框 
Private fun initSpinner() { 
sp bg.visibility = View.GONE 
tv spinner.visibility = View.VISIBLE 
tv_spinner.text = colorNames [mSeq] 
tv_spinner.setOnClickListener { 
ctx!1!.selector ("请 选择 页 面 背景 色 "，colorNames) { i -> 
tv_spinner.text = ColorNames [il] 
mSeq = i 
// 设 置 广播 意图 的 名 称 为 BroadcastFragment .EVENT 
val intent = Intent (BroadcastFragment .EVENT) 
intent.putExtra("seq", i) 
intent.putExtra("color", colorIds[i]) 
// 已 选择 新 颜色 ， 则 发 送 背景 色 变更 的 广播 


ctx!!.sendBroadcast (intent) 


companion object { 
// 静 态 属性 如 果 是 个 常量 ， 就 还 要 添加 修饰 符 const 


const val EVENT = "com.example.complex.fragment .BroadcastFragment" 


fun newInstance (position: Int, image id: Int, desc: String): 

BroadcastFragment { 

val fragment = BroadcastFragment () 

val bundle = Bundle() 

bundle.putInt ("position", position) 

bundle.putInt ("image id", image id) 

bundle.putSstring ("desc", desc) 

fragment .arguments = bundle 

return fragment 


EF 


因为 广播 的 发 送 和 接收 不 依赖 于 任何 组 件 中 转 ， 所 以 适配器 代码 无 须 添加 任何 广播 处 理 代码 ， 
只 需 在 Activity 页 面 代码 中 补充 广播 接收 处 理 即 可 。 添 加 了 广播 接收 处 理 的 Kotlin 页 面 代码 如 下 
所 示 : 


class BroadTempActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout .activity broadcast temp) 
pts_tab.setTextSize (TypedValue.COMPLEX UNIT SP, 20f) 
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VP_content .adapter = BroadcastPagerAdapter (supportFragmentManager, 
GoodsInfo.defaultList) 
VP_content .currentItem = 0 


Public override fun onStart() { 
super.onstart () 
bgChangeReceiver = BgChangeReceiver() 
// 声 明 一 个 过 滤器 ， 明 确 只 接收 名 称 为 BroadcastFragment .EVENT 的 广播 
val filter = IntentFilter (BroadcastFragment .EVENT) 
// 在 活动 启动 时 注册 广播 接收 器 
registerReceiver (bgChangeReceiver, filter) 


) 


Public override fun onStop() { 
// 在 活动 停止 时 注销 广播 接收 器 
unregisterReceiver (bgChangeReceiver) 
Super .onStop () 

有 


Private var bgChangeReceiver: BgChangeReceiver? = null 
// 定 义 一 个 背景 色 变更 的 广播 接收 器 
Private inner class BgChangeReceiver : BroadcastReceiver() { 
override fun onReceive (Context: Context, intent: Intent?) { 
if (intent != null) { 
// 从 广播 消息 中 获取 新 颜色 ， 并 将 页 面 背景 色 修改 成 新 颜色 
val color = intent.getIntExtra("color", Color.WHITE) 
11 brd temp.setBackgroundColor (color) 


} 


上 述 的 碎片 以 及 页 面 代码 新 增 的 Kotlin 语法 主要 是 修饰 符 const。 倘若 按照 字面 意思 ,被 const 
修饰 的 属性 是 个 常量 属性 ， 似 乎 跟 val 的 只 读 变量 没什么 区 别 ， 那 为 什么 代码 声明 EVENT 这 个 广 
播 事件 名 称 时 ， 既 加 了 const 修饰 又 加 了 val 修饰 呢 ? 这 说 明 二 者 之 间 其 实 还 是 有 所 差别 的 ， 要 想 
弄 清楚 其 中 的 差异 ， 得 先 了 解 两 种 常量 概念 : 编译 时 常量 和 运行 时 常量 。 


1. 编译 时 常量 

这 种 类 型 的 常量 的 值 早 在 编译 期 间 就 已 经 确定 ， 相 当 于 这 个 常量 值 被 固化 到 了 App 安装 包 里 
面 。 无 论 App 在 哪 部 手机 上 安装 、 在 何 时 运行 ， 编 译 时 常量 的 值 都 是 统一 且 唯 一 的 ， 不 会 随 环境 
的 变化 产生 任何 变化 。 





2. 运行 时 常量 
这 种 类 型 的 常量 其 实 不 是 严格 意义 上 的 常量 ， 更 确切 地 说 ， 应 该 是 一 个 仅 能 赋值 一 次 的 只 读 


194 | Kotlin 从 零 到 精通 Android 开发 


属性 。 运行 时 常量 的 赋值 操作 可 以 在 声明 属性 时 就 赋值 ， 也 可 以 在 首次 使 用 时 赋值 ， 并 且 赋 值 的 时 
候 ， 还 可 以 把 另 一 个 变量 的 数值 赋 给 val 变量 。 也 就 是 说 ，App 在 每 次 启动 运行 之 后 ， 运 行 时 常量 
都 可 能 被 赋予 不 同 的 数值 ， 只 是 一 旦 完成 赋值 ， 其 值 就 不 能 再 做 修改 。 
由 此 可 见 ， 编 译 时 常量 才 是 真正 意义 上 的 常量 ， 而 运行 时 常量 是 容易 使 人 迷惑 的 伪 常量 。 之 所 
以 前 面 的 Kotlin 代码 将 EVENT 声明 为 const 常量 ， 是 因为 系统 注册 广播 接收 器 时 要 求 这 个 广播 的 名 
称 是 唯一 的 ， 不 然 这 次 运行 是 这 个 广播 名 称 ， 下 次 运行 又 是 另 一 个 广播 名 称 ， 实 在 让 系统 无 所 适 从 。 
解释 完了 const 的 用 法 ， 再 来 看 看 实际 运行 的 广播 效果 ， 一 开始 页 面 背景 是 淡 灰 色 的 ， 如 图 7-39 
所 示 ; 接着 在 碎片 内 部 的 下 拉 框 中 选择 红色 ， 于 是 整个 页 面 的 背景 色 都 变 成 红色 了 ,如 图 7-40 所 示 。 
iPhone8 Mate1( 
切换 背景 红色 


I 














Apple iPhone 8 256GB 玫瑰 金色 移动 联通 
电信 4G 手 机 


图 7-39 临时 广播 未 发 送 前 的 界面 图 7-40 临时 广播 发 送 后 的 界面 


7.4.2 ”接收 系统 广播 


7.4.1 小 节 介 绍 的 临时 广播 指 的 是 App 自身 发 出 来 的 局 部 广播 , 一旦 该 App 退出 运行 ， 就 无 法 
继续 收发 临时 广播 。 显 然 这 个 临时 广播 的 受众 面 狭小 ， 如 果 App 希望 满足 某 种 特定 条 件 〈 如 开机 
启动 、 用 户 解锁 、 时 刻 到 达 、 网 络 切换 等 ) ， 就 自动 执行 相应 的 事务 处 理 ， 这 要 求 App 去 接收 来 
自 Android 系统 的 系统 广播 。 系统 广播 是 Android 发 现 产 生 某 种 系统 事件 之 时 ， 向 手机 上 所 有 应 用 
发 送 通知 的 全 局 广播 。 

系统 广播 的 注册 方式 有 两 种 : 静态 注册 和 动态 注册 ， 分 别 说 明 如 下 。 


1. 静态 注册 方式 

静态 注册 适用 于 开机 启动 、 用 户 解锁 、 定 时 闸 钟 等 系统 事件 ， 该 方式 无 论 App 当前 是 否 正在 
运行 ， 只 要 注册 了 系统 广播 的 接收 器 ， 一 旦 广播 对 应 的 系统 事件 发 生 ， 那 么 App 都 得 恢复 运行 去 
处 理 接收 器 的 事务 。 

静态 注册 方式 要 在 AndroidManifestxml 中 添加 广播 接收 器 的 receiver 节点 配置 ， 详 细 的 配置 
方法 示例 如 下 : 

<receiver android:name=".receiver.BootCompletedReceiver" > 
<intent-filter> 
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<action android:name="android.intent.action.BOOT COMPLETED" /> 
</intent-filter> 
</receiver> 


然后 编写 BootCompletedReceiver 类 的 具体 代码 ,在 类 内 部 进行 响应 开机 启动 的 业务 逻辑 操作 。 


2. 动态 注册 方式 
动态 注册 适用 于 分 钟 到 达 广播 、 网 络 切换 广播 、 电 量变 化 广播 等 ， 由 于 该 方式 必须 在 App 代 
码 中 注册 广播 接收 器 ， 因 此 只 有 App 启动 之 后 才能 正常 接收 广播 。 假 如 App 没有 启动 ， 或 者 启动 
之 后 又 退出 运行 ， 那 就 不 能 再 接收 广播 了 。 
下 面 是 采取 动态 注册 方式 实现 监听 分 钟 广播 的 Kotlin 代码 例子 : 
class BroadSystemActivity : AppCompatActivity() { 
var desc = "开始 侦 听 分 钟 广播 ， 请 稍 等 。 注 意 要 保持 屏幕 亮 着 ， 才 能 正常 收 到 广播 " 


override fun onCreate (savedInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 
setContentView(R.layout.activity broadcast system) 
tv_system.text = desc 


} 


override fun onStart() { 
Super .onStart () 
timeReceiver = TimeReceiver() 
// 声 明 一 个 过 滤器 ， 只 接收 名 称 为 Intent .ACTION TIME TICK 的 分 钟 广播 
val filter = IntentFilter(Intent.ACTION TIME TICK) 
// 在 活动 启动 时 注册 广播 接收 器 
registerReceiver (timeReceiver, filter) 


override fun onStop () { 
super.onstop() 
// 在 活动 停止 时 注销 广播 接收 器 
unregisterReceiver (timeReceiver) 


k 


Private Var timeReceiver: TimeReceiver? = null 
// 定 义 一 个 时 间 广 播 的 接收 器 
inner class TimeReceiver : BroadcastReceiver() { 
override fun onReceive(context: Context, intent: Intent?) { 
if (intent != null) { 
desc = "$desc\n${DateUtil.nowTime} 收 到 一 个 ${intent.action} 广 播 " 
tv_system.text = desc 
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分 钟 广播 的 监听 结果 如 图 7-41 所 示 ， 当 前 时 间 正 好 是 13 时 25 分 0 秒 ， 表 示 整 分 的 时 刻 才 会 
出 现 分 钟 广播 。 


complex 


开始 侦 听 分 钟 广播 ， 请 稍 等 。 注 意 要 保持 屏幕 
收 到 广播 





android.intent.action.TIME_TICK 广 播 


图 7-41 接收 到 系统 发 送 的 分 钟 广播 
7.5 “实战 项 目 : 电 商 App 的 商品 频道 


常言 道 ， 人 生 若 只 如 初 见 ， 说 明 对 事物 的 第 一 印象 是 很 重要 的 ， 这 话 对 于 电 商 App 而 言 同样 
适用 。 卖 东西 任 的 是 什么 ? 首先 ， 不 是 赁 卖家 的 自 吹 自 擂 ， 因 为 王 婆 卖 瓜 ， 自 卖 自 压 ， 顾 客 可 不 是 
傻子 。 其 次 ， 也 不 是 赁 商品 的 标价 ， 因 为 生意 场 上 一 分 钱 一 分 货 ， 价 格 低 了 质量 就 没 保障 ， 价 格 高 
了 顾客 会 货 比 三 家 。 再 次 ， 名 气 也 不 一 定 可 靠 ， 因 为 名 气 大 往往 意味 着 故 步 自 封 、 不 思 进 取 ， 像 手 
机 行业 里 的 摩托 罗拉 、 诺 基 亚 等 身 鉴 不 远 。 卖 东西 的 关键 条 件 之 一 是 要 抓 住 顾客 的 眼球 ,所谓 百 闻 
不 如 一 见 ， 你 让 顾客 看 着 顺眼 、 觉 得 舒服 ， 这 单 买卖 就 算 不 成 ， 也 还 留 下 仁义 。 于 是 本 节 通 过 “ 电 
商 App 的 商品 频道 ”这 个 实战 项 目 深入 探讨 如 何在 有 限 的 屏幕 空间 内 吸引 用 户 的 关注 、 激 发 用 户 
的 购买 欲望 。 


7.5.1 需求 描述 


购物 不 分 男女 老少 ， 每 个 群体 的 品位 都 大 不 一 样 ， 可 是 电 商 App 的 商品 列表 往往 只 有 一 个 页 
面 , 要 想 在 一 个 页 面 内 展示 不 同 的 风格 , 可 考虑 根据 频道 分 类 来 显示 与 该 频道 吻合 的 背景 色 。 例如 ， 
图 7-42 所 示 的 服装 频道 大 多 展示 女士 的 衬 装 ， 此 时 的 导航 栏 背 景 适合 显示 粉红 背景 ， 如 图 7-43 所 
示 的 电器 频道 展示 彩电 、 冰箱 、 洗 衣 机 等 家 用 电器 ,此 时 的 导航 栏 背景 更 适合 展示 体现 金属 质感 的 
蓝 色 背景 。 

不 同 商品 的 尺寸 规则 各 不 相同 ， 像 裙子 分 长 裙 和 短 裙 ， 家 电 里 面 彩电 比较 宽 而 冰箱 比较 高 ， 
所 以 展示 商品 的 时 候 ， 有 的 商品 图 片 会 宽 一 些 ， 有 的 商品 图 片 会 高 一 些 。 对 应 这 种 长 短 不 一 的 图 片 
展示 ,就 需要 采取 瀑布 流 效果 的 交错 列表 ,具体 如 图 7-44 和 图 7-45 所 示 ， 其 中 图 7-44 展示 服装 频 
道 往 上 拉动 后 的 界面 ， 图 7-45 展示 电器 频道 往 上 拉动 后 的 界面 。 

另外 ， 前 面 的 商品 页 面 允许 往 上 拉动 显示 页 面 下 方 的 商品 ， 同 时 支持 左右 滑动 来 切换 不 同 的 
商品 频道 , 这 样 有 了 三 个 方向 的 手势 , 还 剩 一 个 往 下 拉动 的 手势 可 用 来 下 拉 刷 新 。 用 户 在 商品 页 面 
向 下 拉动 时 ， 如 果 已 经 拉 到 页 面 顶端 还 在 下 拉 ， 则 通常 表示 用 户 希 望 换 一 批 商品 更 新 页 面 。 此 时 应 
当 触 发 下 拉 刷 新 动作 ， 在 界面 上 提示 商品 页 面 正在 刷新 ， 提 示 效 果 如 图 7-46 所 示 。 接 着 电 商 App 在 
商品 列表 项 端 更 换 新 的 一 批 商品 ， 此 时 完成 下 拉 刷 新 的 界面 如 图 7-47 所 示 。 


第 7 章 Kotlin 操纵 复杂 控件 | 197 








图 7-43 电 商 App 的 电器 频道 界面 ”图 7-44 服装 频道 上 拉 之 后 的 界面 


服装 


图 742 电 商 App 的 服装 频道 界面 








电器 频道 上 拉 之 后 的 界面 ”图 7-46 服装 频道 正在 刷新 的 界面 ”图 7-47 服装 频道 刷新 完成 的 界面 
如 此 一 来 ， 这 个 电 商 App 的 商品 频道 既 考 虑 到 各 种 顾客 群体 的 视觉 偏好 ， 还 充分 兼顾 有 限 屏 
幕 空间 与 多 样 商品 图 片 之 间 的 相处 ， 又 同时 支持 上 、 下 、 左 、 右 4 个 方向 的 滑动 /滚动 /拉动 手势 响 


都 是 为 了 让 顾客 看 着 舒服 、 用 着 顺手 。 


7-45 





应 ， 花 费 许 多 心思 ， 
7.5.2 ”开始 热身 : 下 拉 刷 新 布局 SwipeRefreshLayout 


电 商 App 在 商品 列表 页 面 往往 提供 下 拉 刷 新 功能 ， 把 列表 页 面 整体 下 拉 即 可 触发 页 面 刷新 操 
作 。Android 为 此 提供 了 下 拉 刷 新 控件 SwipeRefreshLayout， 可 用 于 实现 简单 的 下 拉 刷 新 功能 。 
下 面 是 SwipeRefreshLayout 的 常用 属性 /方法 说 明 。 
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@ isRefreshing: 该 属性 表示 刷新 的 状态 ，true 表示 正在 刷新 ，false 表示 结束 刷新 。 注 意 ，Kotlin 
利用 isRefreshing 属性 取代 了 原来 的 setRefreshing 和 isRefreshing 两 个 方法 。 

”setOnRefreshListener: 设置 刷新 监听 器 .需要 重 写 监听 器 OnRefreshListener 的 onRefresh 方法 ， 
该 方法 在 下 拉手 势 松 开 时 触发 。 
setColorSchemeColors: 设置 进度 圆圈 的 圆 环 颜色 列表 。 
setProgressBackgroundColorSchemeColor: 设置 进度 圆圈 的 背景 颜色 列表 。 
setProgressViewOffset: 设置 进度 圆圈 的 偏 移 量 。 第 一 个 参数 表示 进度 圈 是 否 缩放 ， 第 二 个 参 
数 表示 进度 圈 开 始 出 现时 距 项 端的 偏 移 ， 第 三 个 参数 表示 进度 圈 拉 到 最 大 时 距 项 端的 偏 移 。 


需要 注意 的 是 , SwipeRefreshLayout 节点 下 面 只 能 有 一 个 直接 子 视图 , 如 果 有 多 个 直接 子 视 图 ， 
那么 只 会 展示 第 一 个 子 视图 , 后 面 的 子 视图 将 不 予 展 示 。 而 且 这 个 直接 子 视图 还 必须 是 允许 滚动 的 
控件 ， 比 如 ScrollView、ListView、GridView、RecyclerView、NestedScrollView 等 ， 如 果 没 有 这 些 
可 滚动 的 视图 ， 就 无 法 支持 下 拉 刷 新 操作 。 下 面 以 仿 微 信 公众 号 的 消息 列表 为 例 给 出 
SwipeRefreshLayout 搭配 RecyclerView 的 布局 文件 样 例 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout_ height="match parent" 
android:orientation="vertical" 
android:padding="5dp" > 


<android.support .v4.widget .SwipeRefreshLayout 
android:id="@+id/srl dynamic" 
android:layout width="match parent" 
android:layout height="match parent" > 


<android.support .v7.widget.RecyclerView 





android:id="@+id/rv_dynamic" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:background="#aaaaff" /> 

</android.support .v4.widget.SwipeRefreshLayout> 


</LinearLayout> 
上 面 仿 公众 号 消息 列表 布局 对 应 的 Kotlin 页 面 代码 如 下 所 示 : 


// 由 活动 页 面 实现 下 拉 刷 新 接口 onRefreshListener 
class SwipeRecyclerActivity : AppCompatActivity(), OnRefreshListener, 
OnItemClickListener, OnItemLongClickListener, OnItemDeleteClickListener { 
lateinit var adapter: RecyclerSwipeAdapter 
Private var currents = RecyclerInfo.defaultList 
Private var alls = RecyclerInfo.defaultList 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 


第 7 章 Kotlin 操纵 复杂 控件 | 199 


setContentView(R.layout .activity swipe recycler) 

// 设 置 下 拉 刷 新 的 监听 器 对 象 

srl dynamic.setOnRefreshListener (this) 

// 设 置 刷新 时 转圈 圈 动 画 的 渐变 颜色 列表 

srl dynamic.setColorSchemeResources (R.color.red, R.color.orange, 
R.color.green, R.color.blue) 

rv dynamic.layoutManager = LinearLayoutManager (this) 

adapter = RecyclerSwipeAdapter (this, currents) 

adapter.setOnItemClickListener (this) 

adapter.setOnItemLongClickListener (this) 

adapter.setOnItemDeleteClickListener (this) 

rv_dynamic.adapter = adapter 

rv dynamic.itemAnimator = DefaultIitemAnimator () 

rv dynamic.addItemDecoration (SpacesItemDecoration(1)) 


// 监 听 器 接口 onRefreshListener 需要 实现 onRefresh 方法 完成 刷新 的 事务 处 理 


override fun onRefresh() { 
mHandler.postDelayed (mRefresh, 2000) 


Handler () 

Private val mRefresh = Runnable { 
// 下 拉 刷 新 结束 ， 要 把 isRefreshing 设置 为 false， 以 便 从 界面 上 去 除 转圈 图 标 
srl_dynamic.isRefreshing = false 
val position = (Math.random() * 100 $% alls.size) .toInt() 


Private val mHandler 


val old item = alls[position] 


RecyclerInfo(old item.pic id, old item.title, 


val new item 
old item.desc) 

// 每 次 刷新 之 时 ， 往 循环 视图 列表 项 部 添加 一 条 信息 

currents.add(0, new item) 

// 通 知 循环 适配器 在 第 0 项 发 生 了 添加 操作 

adapter.notifyItemInserted (0) 

// 让 循环 视图 滚动 到 第 0 项 的 位 置 


rv _ dynamic.scrollToPosition(0) 


// 实 现 单项 的 点 击 方法 


override fun onItemClick(view: View, position: Int) { 
val desc = "您 点 击 了 第 ${position+1} 项 ， 标 题 是 ${currents[position] .title}" 
toast (desc) 


// 实 现 单项 的 长 按 方法 


override fun onIitemLongClick (view: View, position: Int) { 
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// 长 按时 在 该 项 右边 弹出 删除 按钮 

currents[position] .pressed = !(currents [Position] .pressed) 
// 通 知 循环 适配器 在 第 Position 项 发 生 了 变更 操作 

adapter .notifyItemChanged (position) 


// 实 现 单项 内 部 删除 按钮 的 点 击 方法 

override fun onItemDeleteClick(view: View, position: Int) { 
// 移 除 当前 项 
currents.removeAt (Position) 
// 通 知 循环 适配器 在 第 position 项 发 生 了 移 除 操作 


adapter.notifyItemRemoved (position) 


} 

上 述 仿 公众 号 消息 列表 的 下 拉 刷 新 效果 如 图 7-48 一 图 7-52 所 示 , 其 中 图 7-48 所 示 为 公众 号 列 
表 的 初始 界面 ， 图 7-49 所 示 为 下 拉 列 表 触 发 刷新 动作 时 的 界面 ， 图 7-50 所 示 为 刷新 完毕 在 列表 项 
部 添加 了 新 消息 后 的 界面 ， 图 7-51 所 示 为 长 按 某 消息 弹出 删除 按钮 时 的 界面 ,图 7-52 所 示 为 点 击 
删除 按钮 移 除 该 项 消息 后 的 界面 。 





complex complex complex 





图 748 ”公众 号 列表 的 初始 界面 ”图 749 下 拉 刷 新 时 的 等 待 界面 ”图 7-50 刷新 结束 添加 新 消息 的 列表 


complex complex 
首都 日 报 
首都 日 报 
海峡 时 报 


OO 北方 周末 


参照 消 筷 
加 





图 7-51 长 按 某 项 消息 弹出 删除 按钮 图 7-52 点击 删除 按钮 之 后 的 消息 列表 
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7.5.3 ”控件 设计 


商品 频道 的 页 面 看 起 来 既 丰 富 又 紧凑 ,其 中 运用 了 不 少 Android 复杂 控件 , 且 待 笔者 细 细 列举 
如 下 。 


(1) 工具 栏 Toolbar: 页 面 顶 部 的 导航 栏 ， 不 用 说 就 是 工具 栏 Toolbar。 

(2) 标签 布局 TabLayout: 频道 页 面 项 部 的 “服装 ”和 “电器 ”标签 ， 用 到 了 标签 布局 。 

(3) 翻 页 视图 ViewPager: 与 TabLayout 配合 使 用 ， 文 本 标签 的 切换 对 应 着 翻 页 视图 的 内 部 
页 面 切 换 。 

(4) 碎片 Fragment: 每 一 类 的 商品 页 面 由 相应 的 一 个 Fragment 构成 。 

(5) 循环 视图 RecyclerView: 在 碎片 布局 内 部 ， 服 装 图 片 和 电器 图 片 的 交错 展示 效果 ， 运 用 
了 循环 视图 的 瀑布 流 网 格 布局 。 

(6) 循环 适配器 RecyclerView.Adapter: 每 个 商品 的 图 片 和 名 称 经 由 循环 适配器 从 而 组 装 成 
完整 的 商品 列表 。 

(7) 碎片 适配器 FragmentStatePagerAdapter: 通过 碎片 适配器 才能 将 几 个 碎片 页 封装 进 翻 页 
视图 。 

(8) 下 拉 刷 新 布局 SwipeRefreshLayout: 循环 视图 借助 下 拉 刷 新 布局 方 可 触发 下 拉 刷 新 操作 。 


除 此 之 外 ,这 个 商品 频道 的 实战 项 目 还 用 到 了 广播 Broadeast, 一 旦 用 户 选 中 具体 的 分 类 页 面 ， 
则 该 分 类 页 对 应 的 碎片 对 象 内 部 发 出 背景 色 变 更 的 广播 ,然后 注册 了 广播 接收 器 的 频道 主页 面 接收 
到 该 广播 ， 并 把 项 部 导航 栏 的 背景 色 改 为 新 的 颜色 。 


7.5.4 “关键 代码 


为 了 方便 读者 更 好 、 更 快 地 使 用 Kotlin 编码 完成 商品 频道 项 目 ， 下 面 列 举 几 个 重要 功能 的 
Kotlin 代码 片段 。 


1. 关于 频道 页 面 的 翻 页 适配器 

翻 页 适配器 的 Kotlin 编码 本 身 挺 简单 ， 只 需 按 照 规 矩 重 写 getItem、getCount、getPageTitle 三 
个 方法 就 好 了 。 这 里 所 说 的 重点 是 , 广播 过 滤器 要 求 注册 用 的 广播 名 称 必须 是 常量 , 注意 还 必须 是 
一 开始 就 确定 下 来 的 编译 时 常量 ， 故 而 适配器 内 部 定义 的 广播 名 称 EVENT 字段 务必 要 加 上 const 
修饰 符 ， 否 则 编译 会 提示 失败 。 

下 面 是 商品 频道 对 应 的 Kotlin 翻 页 适配器 代码 例子 : 

class ChannelPagerAdapter (fm: FragmentManager, private val titles: 
MutableList<String>) : FragmentPagerAdapter (fm) { 


// 获 取 每 个 页 面 的 碎片 对 象 

override fun getItem(Position: Int) : Fragment = when (Position) { 
0 -> ClothesFragment () 
1 -> AppliancesFragment () 
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else -> ClothesFragment () 
， 


// 获 取 页 面 的 数量 


override fun getCount(): Int = titles.size 


// 获 取 页 面 的 标题 


override fun getPageTitle (position: Int) : CharSequence = titles[position] 


companion object { 
// 广 播 过 滤器 的 广播 名 称 必须 是 编译 时 常量 


const val EVENT = "com.example.complex.adapter.ChannelPagerAdapter" 


} 


2. 关于 循环 视图 的 列表 刷新 
循环 视图 的 列表 数据 发 生变 化 之 后 , 调用 循环 适配器 的 notifyDataSetChanged 方法 通知 系统 现 
在 适配器 列表 发 生 了 数据 变更 。 然 而 这 个 处 理 还 不 够 完善 , 假设 现在 循环 视图 的 列表 项 已 经 占 满 整 
个 屏幕 , 此 时 再 往 顶 部 添加 一 条 新 记录 , 就 会 感觉 屏幕 上 的 列表 没有 发 生变 化 , 也 没 看 到 插入 动画 。 
实际 上 循环 视图 项 部 确实 有 添加 新 记录 , 把 列表 项 往 下 拉 就 能 看 到 , 出现 这 个 问题 的 原因 是 循环 视 
图 更 新 之 后 并 不 会 自动 下 拉 。 要 解决 这 个 问题 ， 得 在 notifyDataSetChanged 方法 调用 之 后 ， 再 调用 
循环 视图 对 象 的 scrollToPosition(0) 方 法 ， 表 示 把 列表 项 滚动 到 顶部 的 第 一 条 记录 。 
下 面 是 添加 上 述 修改 之 后 的 Kotlin 下 拉 刷 新 代码 片段 : 
override fun onRefresh() { 
// 延 迟 两 秒 ， 模 拟 请 求 新 一 批 商品 的 网 络 延 时 
mHandler .postDelayed (mRefresh, 2000) 
} 


Private val mHandler = Handler() 
Private val mRefresh = Runnable { 
// 下 拉 刷 新 结束 ， 要 把 isRefreshing 设置 为 false， 以 便 从 界面 上 去 除 转圈 图 标 
srl_clothes.isRefreshing = false 
Val 1 = alls.size -1 
var count = 0 
while (count < 5) { 
val item = alls[i] 
alls.removeAt (i) 
alls.add(0, item) 
Count++ 
} 
// 通 知 循环 适配器 发 生 了 数据 变更 
adapter .notifyDataSetChanged () 
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// 让 循环 视图 滚动 到 第 0 项 的 位 置 
rv_clothes.scrollToPosition(0) 
. 


3. 关于 碎片 的 选中 事件 
前 面 提 到 , 翻 页 视图 的 选中 事件 可 通过 监听 器 OnPageChangeListener 的 onPageSelected 方法 来 
判断 。 但是， 如果 背景 色 变更 的 广播 是 从 碎片 内 部 发 出 来 的 ,那么 就 得 判断 当前 是 哪 一 个 碎片 处 于 
选中 状态 。 本 来 按照 常规 ， 重 写 Fragment 类 的 setUserVisibleHint 方法 即 可 ， 但 这 里 有 个 问题 : 首 
次 打开 翻 页 视图 时 ， 默 认 显 示 第 一 个 标签 页 ， 此 时 该 标签 页 的 生命 周期 为 
onAttach->setUserVisibleHint->onCreateView， 显 然 在 这 种 情况 之 下 ， 由 于 setUserVisibleHint 方法 
在 onCreateView 方法 之 前 调用 ， 造 成 App 还 没 来 得 及 在 onCreateView 方法 中 给 ctx 变量 赋值 ， 因 
此 这 时 候 上 下 文 对 象 为 空 ， 也 就 无 法 发 送 广播 。 为 了 避免 上 面 说 的 意外 情况 ， 就 要 在 
setUserVisibleHint 方 法 内 部 增加 ctx 变量 是 否 为 空 的 判断 ， 只 有 上 下 文 对 象 非 空 ， 才 能 继续 向 外 发 
送 广播 。 
下 面 便 是 setUserVisibleHint 方法 增加 了 非 空 判断 的 Kotlin 碎片 代码 : 
Override fun setUserVisibleHint (isVisibleToUser: Boolean) { 
super.setUserVisibleHint (isVisibleToUser) 
// 如 果 该 页 是 一 打开 的 默认 页 ，setUserVisibleHint 就 先 于 onCreateView 执 行 ， 此 时 ctx 
为 空 
4£ (ctx l= nolly { 
val intent = Intent (ChannelPagerAdapter .EVENT) 
intent.putExtra("color", ctx!!.resources.getColor (R.color.pink)) 
ctx!!.sendBroadcast (intent) 


7.6 小 结 


本 章 主 要 介绍 了 Kotlin 如 何 实现 几 种 复杂 控件 的 调用 ， 包 括 常 见 的 几 种 视图 排列 〈 下 拉 框 、 
列表 视图 、 网 格 视图 、 循 环视 图 ) 、 新 颖 的 材质 设计 协调 布局 、 工 具 栏 、 应 用 栏 布局 、 可 折 邯 工 
具 栏 布局 ) 、 页 面 切 换 的 几 种 实现 方式 〈 翻 页 视图 、 碎 片 布局 、 标 签 布 局 ) 、Broadcast 广播 组 件 
的 广播 发 送 以 及 广播 接收 器 的 几 种 用 法 〈 临 时 广播 、 系 统 广播 ) 。 最 后 设计 了 一 个 实战 项 目 “ 电 商 
App 的 商品 频道 ”在 该 项 目的 Kotlinn 编码 中 ,采用 了 前 面 介绍 的 大 部 分 布局 和 控件 , 以 及 Broadcast 
广播 的 发 送 和 接收 操作 ， 另 外 还 介绍 了 Kotlin 对 下 拉 刷 新 布局 的 用 法 。 

通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 5 种 开发 技能 : 

(1) 学 会 使 用 Kotlin 操纵 常见 的 视图 排列 ， 除 了 下 拉 框 、 列 表 视 图 、 网 格 视图 、 循 环视 图 的 
常规 用 法 之 外 ， 重 点 掌握 Kotlin 对 循环 适配器 的 几 项 关键 技术 运用 (lateinit 延迟 初始 化 属性 、 
LayoutContainer 布局 容器 插件 以 及 函数 参数 在 适配器 中 的 应 用 ) 。 
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(2) 学 会 使 用 Kotlin 操纵 新 颖 的 材质 设计 ， 除 了 协调 布局 、 工 具 栏 、 应 用 栏 布局 、 可 折 羡 工具 
栏 布局 的 常规 用 法 之 外 ， 还 需 了 解 并 掌握 支付 宝 首页 头 部 伸缩 的 原理 及 其 基础 实现 过 程 。 

(3) 学 会 使 用 Kotlin 操纵 页 面 切换 的 实现 方式 ， 除 了 翻 页 视图 、 碎 片 布局 、 标 签 布局 的 常规 
用 法 之 外 ， 重 点 复习 引用 相等 的 概念 及 其 适用 的 场合 。 

(4) 学 会 使 用 Kotlin 进行 Broadcast 组 件 的 广播 发 送 和 广播 接收 操作 ， 其 中 重点 了 解 两 种 常 
量 的 概念 及 其 区 别 ， 并 掌握 修饰 符 const 的 使 用 场景 。 

(5) 学 会 使 用 Kotlin 操纵 下 拉 刷 新 布局 。 





Kotlin 进行 数据 存储 


本 章 介绍 了 Android 四 种 主要 存储 方式 的 用 法 ， 包 括 共享 参数 SharedPreferences、 数 据 库 
SQLite、 文 件 IO 操作 、App 的 全 局 变量 ， 另 外 介绍 了 安 卓 重要 组 件 之 一 Application 的 常见 用 法 。 
最 后 结合 本 章 所 学 的 知识 演示 了 一 个 实战 项 目 “ 电 商 App 的 购物 车 ”的 设计 与 实现 。 





8.1 使 用 共享 参数 SharedPreferences 


共享 参数 是 安 卓 系 统 最 简单 的 数据 持久 化 存储 方式 ， 说 它 简单 不 只 是 因为 存储 结构 简单 ， 也 
是 因为 开发 编码 简单 。 即 使 通过 Java 编写 共享 参数 读 写 的 代码 ， 其 实 不 过 寥寥 几 行 ， 但 要 是 鸡蛋 
里 挑 骨头 ，Java 代码 当然 不 是 那么 完美 。 那 么 Kotlin 究竟 采取 了 哪些 高 科技 手段 ， 使 得 Java 在 
SharedPreferences 方面 也 得 甘 拜 下 风 呢 ? 接 下 来 就 好 好 探讨 Kotlin 对 付 共享 参数 的 新 技术 、 新 手段 。 


8.1.1 共享 参数 读 写 模板 Preference 


共享 参数 SharedPreferences 是 Android 最 简单 的 数据 存储 方式 ， 常 用 于 存 取 “Key-Value” 键 
值 对 数据 。 在 使 用 共享 参数 之 前 ， 首 先 要 调用 getSharedPreferences 方法 声明 文件 名 与 操作 模式 ， 
对 应 的 Java 示例 代码 如 下 : 

SharedPreferences sps = getSharedPreferences ("share", 
Context .MODE PRIVATE); 


该 方法 的 第 一 个 参数 是 文件 名 ， 例 子 中 的 "share" 表 示 当 前 的 共享 参数 文件 是 share.xml; 第 二 
个 参数 是 操作 模式 ， 一 般 填 MODE _ PRIVATE 表示 私有 模式 。 
共享 参数 若 要 存储 数据 ， 则 需 借 助 于 Editor 类 ， 示 例 的 Java 代码 如 下 : 
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SharedPreferences .Editor editor = sps.edit(); 
editor.putString("name"，" 阿 四 ") ; 
editor.putInt ("age", 25); 

editor.putBoolean ("married", false); 
editor.putFloat ("weight", S50f); 

editor.commit (); 


使 用 共享 参数 读 取 数据 则 相对 简单 ， 直 接 调 用 其 对 象 的 get 方法 即 可 获取 数据 ， 注 意 get 方法 
的 第 二 个 参数 表示 默认 值 ， 示 例 的 Java 代码 如 下 : 


String name = sps.getstring("name", ""); 

int age = sps.getIint ("age", 0); 

boolean married = sps.getBoolean("married", false); 
float weight = sps.getFloat ("weight", 0); 


从 上 述 数据 读 写 的 代码 可 以 看 出 ， 共 享 参数 的 存 取 操 作 有 些 烦 琐 ， 因 此 实际 开发 中 常 将 共享 
参数 的 相关 操作 提取 到 一 个 工具 类 , 在 新 的 工具 类 里 面 封装 SharedPreferences 的 常用 操作 ， 下 面 便 
是 一 个 共享 参数 工具 类 的 Java 代码 例子 : 

Public class SharedUtil { 


Private static SharedUtil mUtil; 
Private static SharedPreferences mShared; 


public static SharedUtil getIntance (Context ctx) { 
if (mUtil == null) { 
mUtil = new SharedUtil (); 


} 
mShared = ctx.getSharedPreferences ("share", Context .MODE PRIVATE); 


return mUtil; 


Public void writeShared(String key, String value) { 
SharedPreferences.Editor editor = mShared.edit (); 
editor.putString (key, value); 
editor.commit (); 


public String readShared(String key, String defaultValue) { 
return mShared.getString(key, defaultValue); 


有 了 共享 参数 工具 类 ， 外 部 读 写 SharedPreferences 就 比较 方便 了 ， 比 如 下 面 的 Java 代码 ， 无 
论 是 往 共享 参数 写 数据 还 是 从 共享 参数 读数 据 ， 均 只 要 一 行 代 码 : 


// 调 用 工具 类 写 入 共享 参数 
SharedUtil.getIntance (this) .writeShared("name"，" 阿 四 ") ; 
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// 调 用 工具 类 读 取 共 享 参数 


String name = SharedUtil.getIntance (this) .readShared("name"，"") 7 


当然 这 个 工具 类 还 有 待 进一步 完善 ， 因 为 它 只 支持 字符 串 String 类 型 的 数据 读 写 ， 并 不 支持 
整 型 、 浮 点 数 、 布 尔 型 等 其 他 类 型 的 数据 读 写 。 另 外 ， 如 果 外 部 需要 先 读 取 某 个 字段 的 数值 ， 等 处 
理 完了 再 写 回 共享 参数 ， 那 么 使 用 该 工具 类 也 要 两 行 代 码 (一 行 读 数据 、 一 行 写 数据 ) ， 依 旧 有 从 
简洁 。 挑 刺 找 毛病 其 实 都 是 容易 的 ， 如 果 开 发 者 仍然 使 用 Java 编码 ， 那 么 能 完善 的 就 完善 ， 不 能 
完善 的 也 不 必 苛 求 。 

之 所 以 挑 Java 实现 方式 的 毛病 ， 倒 不 是 因为 看 它 不 顺眼 整 天 吹 毛 求 竟 ， 而 是 因为 Kotlin 有 更 
好 的 解决 办 法 。 为 了 趁 热 打铁 方便 比较 两 种 方式 的 优 劣 ， 下 面 开 门 见 山 直接 给 出 Kotlin 封装 共享 
参数 的 工具 代码 例子 : 


class Preference<T>(val context: Context, val name: String, val default: T) : 
ReadWriteProperty<Any?, T> { 


// 通 过 属性 代理 初始 化 共享 参数 对 象 


Val prefs: SharedPreferences by lazy { context.getSharedPreferences 
("default", Context.MODE PRIVATE) } 


// 接 管 属性 值 的 获取 行为 
override fun getValue (thisRef: Any?, property: KProperty<*>): T { 
return findPreference (name, default) 


// 接 管 属性 值 的 修改 行为 

override fun setValue (thisRef: Any?, property: KProperty<*>, value: T) { 
PutPreference (name, value) 

3 


// 利 用 with 函数 定义 临时 的 命名 空间 
Private fun <T> findPreference (name: String, default: T) : T = with(Prefs) { 
val res: Rny = when (default) { 
is Long -> getLong (name, default) 
is String -> getString (name, default) 
is Int -> getInt (name, default) 
is Boolean -> getBoolean (name, default) 
is Float -> getFloat (name, default) 
else -> throw IllegalArgumentException("This type can be saved into 
Preferences") 
1 


return res as T 


Private fun <T> putPreference (name: String, value: T) = with (Prefs.edit()) { 
//putInt、putString 等 方法 返回 Editor 对 象 
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when (value) { 
is Long -> putLong (name, value) 
is String -> PutString (name, value) 
is Int -> putInt (name, value) 
is Boolean -> putBoolean (name, value) 
is Float -> putFloat (name, value) 
else -> throw IllegalArgumentException("This type can be saved into 

Preferences") 
} .apply () //commit 方法 和 apply 方法 都 表示 提交 修改 
下 
1 


外 部 在 使 用 该 工具 类 时 ， 可 在 Activity 代码 中 声明 来 自 于 Preference 的 委托 属性 ， 委 托 属 性 一 
旦 声明 ， 它 的 初始 值 便 是 从 共享 参数 读 取 的 数值 ， 后 续 代码 若 给 委托 属性 赋值 ， 则 立即 触发 写 入 动 
作 , 把 该 属性 的 最 新 值 保存 到 共享 参数 中 。 于 是 外 部 操作 共享 参数 的 某 个 字段 真正 要 书写 的 仅仅 是 
下 面 的 一 行 委托 属性 声明 代码 : 


// 声 明 字符 串 类 型 的 委托 属性 
Private var name: String by Preference(this, "name", "") 
// 声 明 整 型 数 类 型 的 委托 属性 
Private var age: Int by Preference(this, "age", 0) 
所 谓 百 闻 不 如 一 见 ， 赶 紧 运 行 Kotlin 代码 ， 看 看 它 是 否 真 的 如 传说 中 那 般 神奇 。 果 不 其 然 ， 


Kotlin 通过 Preference 存 取 共享 参数 的 结果 与 Java 是 一 致 的 ,具体 的 测试 界面 效果 如 图 8-1 和 图 8-2 
所 示 ， 其 中 图 8-1 展示 数据 保存 到 共享 参数 的 结果 ， 图 8-2 展示 从 共享 参数 读 取 数据 的 结果 。 







storage 


删除 所 有 记录 


数据 库 查询 到 1 条 记录 ， 详 情 如 下 : 
第 1 条 记录 信息 如 下 : 







婚 否 为 true 
更 新 时 间 为 2017-11-02 15:04:48 











保存 到 共享 参数 
图 8-1 把 注册 信息 保存 到 共享 参数 图 8-2 从 共享 参数 读 取 注册 信息 
8.1.2 ”属性 代理 等 黑 科 技 


既然 Kotlin 对 共享 参数 的 处 理 如 此 传神 , 那么 读者 肯定 很 好 奇 , 这 个 高 大 上 的 Preference 究竟 


科技 ， 且 待 笔者 细 细 道 来 。 
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1. 模板 类 

因为 共享 参数 允许 保存 的 数据 类 型 包括 整 型 、 浮 点 型 、 字 符 串 等 ， 所 以 要 将 Preference 定义 成 
模板 类 ， 具 体 的 参数 类 型 在 调用 时 再 指定 。 

除却 代表 模板 类 泛 型 的 T， 该 类 中 还 有 两 个 与 之 相似 的 元 素 ， 分 别 是 Any 和 *， 各 自 表 示 不 同 
的 含义 。 下 面 简单 说 明 一 下 T、Any 和 * 三 者 之 间 的 区 别 。 


(1) T 是 抽象 的 泛 型 ， 在 模板 类 中 用 来 占 位 子 ， 外 部 调用 模板 类 时 才能 确定 了 的 具体 类 型 。 

(2) Any 是 Kotlin 的 基本 类 型 ， 所 有 Kotlin 类 都 从 Any 派生 而 来 ， 故 而 它 相 当 于 Java 里 面 
的 Object。 

(3) 星 号 “*” 表 示 一 个 不 确定 的 类 型 ， 同 样 也 是 在 外 部 调用 时 才能 确定 ， 这 点 跟 工 比较 像 。 
但 T 出 现在 模板 类 的 定义 中 ， 而 * 与 模板 类 无 关 ， 它 出 现在 单个 函数 定义 的 参数 列表 中 ， 因 此 星 号 
相当 于 Java 里 面 的 问号 “?”。 


2. 委托 属性 /属性 代理 

注意 到 外 部 利用 Preference 声明 参数 字段 时 ， 后 面 跟着 表达 式 “by Preference(...)”， 这 个 by 
表示 代理 动作 , 在 第 5 章 的 “5.3.5 接口 代理 ”就 介绍 了 如 何 让 类 通过 关键 字 by 实现 指定 接口 的 代 
理 ， 当 时 举例 说 明 给 不 同 的 鸟 类 赋予 不 同 的 动作 。 第 5 章 的 例子 是 接口 代理 (或 称 类 代理 ) ， 而 这 
里 则 为 属性 代理 , 所 谓 属性 代理 , 是 说 该 属性 的 类 型 不 变 , 但 是 属性 的 读 写 行为 被 后 面 的 类 接管 了 。 

为 什么 需要 接管 属性 的 读 写 行为 呢 ? 举 个 例子 ， 市 民 每 个 月 都 要 交 电 费 ， 自 己 每 月 跑 去 电力 
营业 厅 交 钱 显 然 够 哈 ， 于 是 后 来 支持 在 电力 网 站 上 自助 缴费 。 然 而 上 网 缴费 仍 显 麻烦 ， 因 为 需要 用 
户主 动 上 网 付费 ， 要 是 用 户 忘记 就 不 好 办 了 。 所 以 很 多 银行 都 推出 了 “委托 代 扣 ” 的 业务 ， 只 要 用 
户 跟 银行 签约 并 指定 委托 扣 费 的 电力 账户 , 那么 在 每 个 月 指定 时 间 , 银行 会 自动 从 用 户 银行 卡 扣 费 
并 缴纳 给 指定 的 电力 账户 ， 如 此 省 却 了 用 户 的 人 工 操作 。 

现实 生活 中 的 委托 扣 费 场景 对 应 到 共享 参数 这 里 ， 开 发 者 的 人 工 操作 指 的 是 : 手工 编码 从 
SharedPreferences 类 读 取 数据 和 保存 数据 。 而 自动 操作 指 的 是 给 出 一 个 约定 : 代理 的 属性 自动 通过 
模板 类 “Preference<T> ”完成 数据 的 读 取 和 保存 ， 也 就 是 说 ，Preference<T> 接 管 了 这 些 属 性 的 读 
写 行为 ， 接 管 后 的 操作 即 为 模板 类 的 getValue 和 setValue 方法 。 因 此 ， 属 性 被 接管 的 行为 叫 作 属 
性 代理 ， 而 被 代理 的 属性 称 作 委托 属性 。 


3. lazy 修饰 符 

模板 类 Preference<T> 声 明了 一 个 共享 参数 的 prefs 对 象 ， 其 中 用 到 了 关键 字 lazy，lazy 的 意思 
是 懒惰 ， 表 示 只 在 该 属性 第 一 次 使 用 时 执行 初始 化 。 联 想到 Kotlin 还 有 类 似 的 关键 字 名 叫 lateinit， 
意思 是 延迟 初始 化 ， 加 上 lazy 可 以 归纳 出 Kotlin 变量 的 三 种 初始 化 操作 ， 有 具体 说 明 如 下 。 


(1) 声明 时 赋值 : 这 是 最 常见 的 变量 初始 化 ， 在 声明 某 个 变量 时 ， 立 即 在 后 面 通过 等 号 “=” 
给 它 赋予 具体 的 值 。 

(2) 通过 关键 字 lateinit 延迟 初始 化 : 变量 声明 时 没有 马上 赋值 ， 但 该 变量 仍 是 个 非 空 变量 ， 
何 时 初始 化 由 开发 者 编码 决定 。 

(3) 通过 修饰 符 lazy 在 首次 使 用 时 初始 化 : 声明 变量 时 指定 初始 化 动作 ， 但 该 动作 要 等 到 变 
量 第 一 次 使 用 时 才 进 行 初 始 化 。 











210 | Kotlin 从 零 到 精通 Android 开发 





此 处 的 prefs 对 象 使 用 lazy 规定 了 属性 值 在 首次 使 用 时 初始 化 ， 且 初始 化 动作 通过 by 后 面 的 
表达 式 来 指定 ， 即 “1{ context.getSharedPreferences("default", ContextMODE _ PRIVATE) } ”。 连 同 
大 括号 在 内 的 这 个 表达 式 其 实 是 个 匿名 实例 ， 它 内 部 定义 了 prefs 对 象 的 初始 化 语句 ， 并 返回 
SharedPreferences 类 型 的 变量 值 。 








4. with 函数 
with 函数 的 书写 格式 形 如 “with( 函 数 头 语句 ) { 函数 体 语句 }”， 看 这 架势 ，with 方法 的 函数 
语句 分 为 两 部 分 ， 详 述 如 下 。 

(1) 函数 头 语句 : 头 部 语句 位 于 紧 跟 with 的 圆 括号 内 部 。 它 先 于 函数 体 语 名 执行， 并 且 头 部 
语句 返回 一 个 对 象 , 函数 体 语 句 在 该 对 象 的 命名 空间 中 运行 。 也 就 是 说 ， 体 语句 可 以 直接 调用 该 对 
象 的 方法 ， 而 无 须 显 式 指定 头 部 对 象 的 实例 名 称 。 

(2) 函数 体 语句 : 体 语句 位 于 常规 的 大 括号 内 部 。 它 要 等 头 部 语句 处 理 完毕 才 会 执行 ， 同 时 
体 语句 在 头 部 语句 返回 对 象 的 命名 空间 中 运行 。 也 就 是 说 ， 体 语句 允许 直接 调用 头 部 对 象 的 方法 ， 
而 无 须 显 式 指定 该 对 象 的 实例 名 称 。 

综 上 所 述 ， 在 模板 类 Preference<T> 的 编码 过 程 中 ， 联 合 运 用 了 Kotlin 的 多 项 黑 科 技 ， 方 才 实 
现 了 优 于 Java 的 共享 参数 操作 方式 。 





8.1.3 ”实现 记 住 密码 功能 


第 6 章 的 实战 项 目 “ 电 商 App 的 登录 页 面 ”， 在 页 面 下 方 有 一 个 “ 记 住 密码 ”的 复 选 框 ， 当 
时 只 是 为 了 演示 控件 CheckBox 的 运用 ， 其 实 并 未 记 住 密码 。 用 户 退 出 后 重新 进入 登录 页 面 ，App 
并 未 自动 填写 上 次 的 用 户 登录 密码 。 现 在 利用 前 面 介绍 的 模板 类 Preference<T> 对 该 项 目 进行 改造 ， 
使 之 实现 记 住 密码 的 功能 。 
改造 过 程 若 采用 Java 编码 ， 则 主要 有 以 下 三 处 改造 内 容 : 
(1) 声明 一 个 SharedPreferences 对 象 ， 并 在 onCreate 函数 中 调用 getSharedPreferences 方法 对 
该 对 象 进行 初始 化 操作 。 
(2) 登录 成 功 时 ， 如 果 用 户 勾 选 了 “ 记 住 密码 ”， 就 使 用 共享 参数 保存 手机 号 码 与 密码 ， 即 
在 loginSuccess 函数 中 增加 如 下 代码 : 
if (bRemember) { 
SharedPreferences.Editor editor = mShared.edit (); 
editor.putString ("phone", et phone.getText() .toString()); 
editor.putString ("password", et password.getText().toString()); 


editor.commit () 7 


} 
(3) 在 打开 登录 页 面 时 ，App 从 共享 参数 中 读 取 手 机 号 码 与 密码 ， 并 展示 在 界面 上 ， 即 在 
onCreate 函数 中 增加 如 下 代码 : 


String Phone = mShared.getString("phone", "™"); 
String password = mShared.getString ("password", ""); 
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et phone.setText (Phone) 7 
et_password.setText (password); 


同样 的 功能 采取 Kotlin 编码 , 改造 内 容 就 很 简单 了 , 仅 需 在 Activity 代码 中 添加 下 面 两 行 委托 
属性 的 声明 语句 : 
Private var Phone: String by Preference(this, "phone", "") 


Private var password: String by Preference(this, "password", "") 
由 于 上 面 的 声明 语句 已经 自动 从 共享 参数 获取 属性 值 ， 接 下 来 车 要 往 共享 参数 保存 新 的 属性 
值 ， 只 需 修改 委托 属性 的 变量 值 即 可 。 
修改 完毕 ， 不 出 意料 的 话 ， 只 要 用 户 上 次 登录 成 功 并 且 已 匀 选 “ 记 住 密码 ”， 那 么 下 次 进入 
登录 页 面 时 , App 就 会 自动 填写 上 次 登录 的 手机 号 码 与 密码 。 具体 的 效果 图 如 图 8-3 和 图 8-4 所 示 ， 
其 中 图 8-3 所 示 为 用 户 首次 登录 成 功 ， 此 时 已 勾 选 “ 记 住 密码 ” 复 选 框 ， 图 8-4 所 示 为 用 户 再 次 进 
入 登录 页 面 ， 因 为 上 回 登 录 成 功 时 有 记 住 密码 ， 所 以 这 次 页 面 自动 展示 保存 的 登录 信息 。 












storage 










@ 密码 登录 





〇 验证 码 登录 






@ 密码 登录 





〇 验证 码 登录 
手机 号 码 ， 1596023 *#*#* 手机 号 码 : 1596023#**##* 








8-3 ”首次 登录 成 功 时 记 住 手 机 号 和 密码 图 8-4 再 次 登录 时 自动 填写 手机 号 和 密码 


8.2 使 用 数据 库 SQLite 


共享 参数 毕竟 只 能 存储 简单 的 键 值 对 数据 ， 如 果 需 要 存 取 更 复杂 的 关系 型 数据 ， 就 要 用 到 数 
据 库 SQLite。 虽 然 操作 数据 库 的 方法 早已 形成 了 一 个 固定 的 套路 ， 但 是 Java 的 数据 库 编码 依旧 依 
赖 于 开发 者 的 编程 素养 ， 无 法 完全 做 到 面向 业务 进行 数据 库 开发 。 而 Kotlin 并 不 墨守成规 ， 努 力 
屏蔽 一 些 与 业务 无 关 的 代码 ， 使 得 利用 Kotlin 进行 数据 库 编 码 更 加 安全 可 靠 。 下 面 一 起 来 探 个 究 
竞 ， 看 看 Kotlin 引入 了 什么 变化 和 改进 。 





8.2.1 数据 库 帮 助 器 SQLiteOpenHelper 


尽管 SQLite 只 是 手机 上 的 轻 量 级 数据 库 ， 但 它 麻 省 虽 小 、 五 脏 俱全 ， 与 Oracle 一 样 存在 数据 
库 的 创建 、 变 更 、 删 除 、 连 接 等 DDL 操作 ， 以 及 数据 表 的 增 、 删 、 改 、 查 等 DML 操作 ， 因 此 开 
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发 者 对 SQLite 的 使 用 编码 一 点 都 不 能 含糊 。Android 为 SQLite 提供 了 两 个 管理 类 ， 分 别 是 
SQLiteDatabase 和 SQLiteOpenHelper， 二 者 的 详细 介绍 如 下 。 


1. SQLiteDatabase 
SQLiteDatabase 是 SQLite 的 数据 库 管 理 类 ， 开 发 者 可 在 Activity 页 面 代码 或 者 任何 能 取 到 
Context 的 地 方 获取 数据 库 实 例 ， 参 考 的 Java 代码 如 下 所 示 : 
// 创 建 数据 库 ， 如 果 已 存在 ， 就 打开 
SQLiteDatabase db = getApplicationContext() .openOrCreateDatabase 
("test.db", Context.MODE PRIVATE, null); 
// 删 除数 据 库 


getApplicationContext () .deleteDatabase ("test .db"); 
SQLiteDatabase 提供 了 若干 操作 数据 表 的 API， 下 面 是 它 的 常用 方法 说 明 。 
openDatabase: 打开 指定 路 径 的 数据 库 。 
isOpen: 判断 数据 库 是 否 已 打开 。 
close: 关闭 数据 库 。 
execSQL: 执行 拼接 好 的 SQL 控制 语句 。 一 般 用 于 建 表 、 删 表 、 变 更 表 结 构 。 
delete: 删除 符合 条 件 的 记录 。 
update: 更 新 符合 条 件 的 记录 。 
insert: 插入 一 条 记录 。 
query: 执行 查询 操作 ， 返 回 结果 集 的 游标 。 
rawQuery: 执行 拼接 好 的 SQL 查询 语句 ， 返 回 结果 集 的 游标 


其 中 , 可 被 insert 和 update 方法 直接 使 用 的 数据 结构 是 ContentValues 类 , 它 类 似 于 映射 Map， 
也 提供 了 put 和 get 方法 用 来 存 取 键 值 对 。 区 别 在 于 ，ContentValues 的 键 只 能 是 字符 串 ， 查 看 
ContentValues 的 源码 会 发 现 其 内 部 保存 键 值 对 的 数据 结构 就 是 HashMap“private HashMap<String, 
Object> mValues;”。 
另外 ， 注 意 表 的 查询 操作 还 要 借助 于 游标 类 Cursor 来 实现 ， 上 面 列举 的 方法 中 ，query 和 
rawQuery 两 个 查询 方法 返回 的 都 是 Cursor 对 象 ， 那 么 获取 查询 结果 就 得 根据 游标 的 指示 一 条 一 条 
遍历 结果 集合 。 下 面 是 游标 Cursor 类 的 常用 方法 。 
(1) 游标 控制 类 方法 ， 用 于 指定 游标 的 状态 。 
close: 关闭 游标 。 
isClosed: 判断 游标 是 否 关 闭 。 
isFirst: 判断 游标 是 否 在 开头 。 
isLast: 判断 游标 是 否 在 末尾 。 


(2) 游标 移动 类 方法 ， 把 游标 移动 到 指定 位 置 。 


”moveToFirst: 移动 游标 到 开头 。 
emoveToLast: 移动 游标 到 末尾 。 
emoveIoNext: 移动 游标 到 下 一 个 。 
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emoveToPrevious: 移动 游标 到 上 一 个 。 
emove: 往 后 移动 游标 若干 偏 移 量 。 
”moveToPosition: 移动 游标 到 指定 位 置 。 
(3) 获取 记录 类 方法 ， 可 获取 记录 的 数量 、 类 型 以 及 取 值 。 
getCount: 获取 记录 数 。 
getmt: 获取 指定 字段 的 整 型 值 。 
getFloat: 获取 指定 字段 的 浮 点 数值 。 
getString: 获取 指定 字段 的 字符 串 值 。 
getType: 获取 指定 字段 的 字段 类 型 。 


2. SQLiteOpenHelper 

SQLiteDatabase 仅仅 提供 数据 库 的 DDL (数据 定义 ) 和 DML (数据 管理 ) 操作 ， 并 未 提供 完 
整 的 业务 处 理 流 程 ， 这 时 SQLiteOpenHelper 就 派 上 用 场 了 。SQLiteOpenHelper 是 SQLite 的 使 用 帮 
助 器 ， 它 是 一 个 数据 库 操 作 的 辅助 工具 ， 用 于 指导 开发 者 合理 使 用 SQLite。 要 想 在 App 开发 中 进 
行业 务 数 据 的 保存 和 读 取 ， 必 须 按照 以 下 步骤 运用 SQLiteOpenHelper。 


人 1 新 建 一 个 数据 库 操作 类 继承 自 SQLiteOpenHelper， 提 示 要 重 写 onCreate 和 onUpgrade 
两 个 方法 。 其 中 ，onCreate 方法 只 在 第 一 次 打开 数据 库 时 执行 ， 在 此 可 进行 表 结 构 创建 的 操作 ， 而 
onUpgrade 方法 在 数据 库 版 本 升 高 时 执行 ， 因 此 在 onUpgrade 函数 内 部 ， 可 以 根据 不 同 的 新 旧版 本 号 
进行 表 结构 变更 处 理 。 
C762 要 封装 保证 数据 库 安全 的 必要 方法 ， 包 括 获取 单 例 对 象 、 打 开 数 据 库 连 接 ， 关 闭 数据 库 
连接 等 。 
(1) 获取 单 例 对 象 : 确保 运行 时 数据 库 只 被 打开 一 次 ， 避 免 重复 打开 数据 库 扔 出 异常 。 
(2) 打开 数据 库 连 接 : SQLite 也 有 锁 机 制 ， 即 读 锁 和 写 锁 的 处 理 ， 故而 数据 库 连 接 也 分 为 两 种 ， 
读 连 接 可 调用 SQLiteOpenHelper 的 getReadableDatabase 方 法 获得 ,而 写 连 接 可 调用 getWritableDatabase 
获得 。 
(3) 关闭 数据 库 连 接 : 数据 库 操作 完毕 ， 应 当 调 用 SQLiteDatabase 对 象 的 close 方法 关闭 数据 
库 连 接 。 
B0103 提供 对 表 记录 进行 增 、 删 、 改 、 查 的 操作 方法 。 


由 此 可 见 ，SQLiteOpenHelper 框架 定义 了 一 个 数据 库 操作 的 代码 准则 ， 该 准则 需要 开发 者 在 编 
码 的 时 候 时 刻 注意 遵守 。 一 旦 开发 者 遗忘 某 项 操作 ， 那 么 数据 库 处 理 极 有 可 能 会 产生 错误 。 





























8.2.2 ”更 安全 的 ManagedSQLiteOpenHelper 


8.2.1 小 节 提 到 ， 系 统 自 带 的 SQLiteOpenHelper 有 个 先天 缺陷 ， 就 是 它 并 未 封装 数据 库 管理 类 
SQLiteDatabase， 这 造成 一 个 后 果 : 开发 者 需要 在 操作 表 之 前 中 手工 打开 数据 库 连 接 ， 然 后 在 操作 
结束 后 手工 关闭 数据 库 连 接 。 可 是 手工 开关 数据 库 连 接 存在 着 诸多 问题 ， 比 如 数据 库 连 接 是 否 重复 
打开 了 、 数 据 库 连 接 是 否 忘记 关闭 了 、 在 A 处 打开 数据 库 却 在 B 处 关闭 数据 是 否 造成 业务 异常 。 
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以 上 的 种 种 问题 都 制约 了 SQLiteOpenHelper 的 安全 性 。 
鉴于 此 ，Kotlin 结合 Anko 库 推 出 了 改良 版 的 SQLite 管理 工具 ， 名 叫 
ManagedSQLiteOpenHelper， 该 工具 封装 了 数据 库 连接 的 开关 操作 ， 使 得 开发 者 完全 无 须 关 心 
SQLiteDatabase 在 何 时 、 在 何 处 调用 , 也 就 避免 了 手工 开关 数据 库 连 接 可 能 导致 的 各 种 异常 。 同 时 ， 
ManagedSQLiteOpenHelper 的 用 法 与 SQLiteOpenHelper 几乎 一 模 一 样 ,唯一 的 区 别 是 :数据 表 的 增 、 
删 、 改 、 查 语句 需要 放 在 use 语句 块 之 中 ， 具 体格 式 如 下 : 
use { 

//1. 插入 记录 

//insert(...) 

//2. 更 新 记录 

//update(...) 

//3. 删除 记录 

//delete(...) 

//4. 查询 记录 

//query(...) 或 者 rawQuery(...) 





} 


接 下 来 ， 以 用 户 注册 信息 数据 库 为 例 ， 看 看 Kotlin 的 数据 库 操作 代码 是 怎样 实现 的 ， 具 体 的 
实现 代码 示例 如 下 : 


class UserDBHelper (Var context: Context, private Var DB_ VERSION: 
Int=CURRENT VERSION) : ManagedSQLiteOpenHelper (context, DB NAME, null, DB VERSION) { 
companion object { 
Private val TAG = "UserDBHelper" 
var DB_NAME = "user.db" // 数 据 库 名 称 
var TABLE NAME = "user info" // 表 名 称 
var CURRENT_ VERSION = 1 // 当 前 的 最 新 版 本 ， 如 有 表 结构 变更 ， 该 版 本 号 要 加 一 
Private var instance: UserDBHelper? = null 
@Synchronized 
fun getInstance(ctx: Context, version: Int=0): UserDBHelper { 
if (instance == null) { 
// 如 果 调用 时 没 传 版 本 号 ， 就 使 用 默认 的 最 新 版 本 号 
instance = if (version>0) UserDBHelper (ctx.applicationContext, 
Version) 
else UserDBHelper (ctx.applicationContext) 
} 


return instance!! 


override fun onCreate (db: SQLiteDatabase) { 
Log.d(TAG, "onCreate") 
val drop sql = "DROP TABLE IF EXISTS $TABLE NAME;" 
Log.d(TAG, "drop_ sql:" + drop_sql) 
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db .execSoL (drop sql) 
val create sql = "CREATE TABLE IF NOT EXISTS STRBLE_NRME ("+ 
" id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL," + 
"name VARCHAR NOT NULL," + "age INTEGER NOT NULL," + 
"height LONG NOT NULL," + "weight FLOAT NOT NULL," + 
"married INTEGER NOT NULL," + "update time VARCHAR NOT NULL" + 
// 演 示 数 据 库 升级 时 要 先 把 下 面 这 行 注释 
"Phone VARCHAR" + ",password VRRCHRR" + ");" 
Log.d(TAG, "create sql:" + create sql) 
db.execSQL (create sql) 





override fun onUpgrade (db:SQLiteDatabase, oldVersion: Int, newVersion: Int) { 
Log.d(TAG, "onUpgrade oldVersion=$oldVersion, newVersion= 
$newVersion") 
if (newVersion > 1) { 
//Android 的 ALTER 命令 不 支持 一 次 添加 多 列 ， 只 能 分 多 次 添加 
var alter sql = "ALTER TABLE $TABLE NAME ADD COLUMN phone VARCHAR;" 
Log.d(TAG, "alter sql:" + alter sql) 
db.execSQL(alter sql) 
alter_ sql = "ALTER TABLE $TABLE NAME ADD COLUMN password VARCHAR;" 
Log.d(TAG, "alter sql:" + alter sql) 
db.execSoL (alter_sql) 


// 删 除 符合 条 件 的 记录 
fun delete(condition: String): Int { 
var count = 0 
use { 
count = delete (TABLE NAME, condition, null) 


return count 


// 添 加 一 条 记录 

fun insert (info: UserInfo) : Long { 
val infoArray = mutableListof (info) 
return insert (infoArray) 


// 删 除 多 条 记录 

fun insert (infoArray: MutableList<UserInfo>): Long { 
Var result: Long = -1 
for (i in infoArray.indices) { 
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val info = infoArray[il] 
Var tempArray: List<UserInfo> 
// 如 果 存 在 同名 记录 ， 就 更 新 记录 
// 注意 条 件 语句 的 等 号 后 面 要 用 单 引 号 括 起 来 
if (info.name.isNotEmpty()) { 
val condition = "name='${info.name}'" 
tempArray = query(condition) 
if (tempArray.size > 0) { 
update (info, condition) 
result = tempArray[0] .rowid 
continue 


// 如 果 存 在 同样 的 手机 号 码 ， 就 更 新 记录 
if (info.phone.isNotEmpty()) { 
val condition = "phone='${info.phone}'" 
tempArray = query(condition) 
if (tempArray.size > 0) { 
update (info，condition) 
result = tempArray[0] .rowid 
continue 


} 
// 车 不 存在 唯一 性 重复 的 记录 ， 则 插入 新 记录 
val cv = ContentValues () 
cv.put ("name", info.name) 
cv.put ("age", info.age) 
cv.put ("height", info.height) 
cv.put ("weight", info.weight) 
cv.put ("married", info.married) 
cv.put ("update time", info.update time) 
cv.put ("phone", info.phone) 
cv.put ("password", info.password) 
use { 
result = insert (TABLE NAME, "", cv) 
} 
// 添加 成 功 后 返回 行 号 ， 失 败 后 返回 -1 
if (result == -1L) { 
return result 


1 


return result 


// 更 新 符合 条 件 的 记录 
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QUJvmoverloads 
fun update (info: UserInfo, condition: String = "rowid=${info.rowid}"): Int { 
val cv = ContentValues () 
cv.put ("name", info.name) 
cv.put ("age", info.age) 
cv.put ("height", info.height) 
cv.put ("weight", info.weight) 
cv.put ("married", info.married) 
cv.put ("update time", info.update time) 
cv.put ("phone", info.phone) 
cv.Pput ("password", info.password) 
var count = 0 
use { 
count = update (TABLE NAME, cv, condition, null) 
} 


return count 


// 查 询 符合 条 件 的 记录 
fun query(condition: String): List<UserInfo> { 
val sql = "select rowid, id,name,age,height,weight,married,update time, 
Phone,password from $TABLE NAME where $condition;" 
Log.d(TAG, "query sql: " + sql) 
var infoArray = mutableListOf<UserInfo>() 
use { 
val cursor = rawQuery(sql, null) 
if (cursor.moveToFirst()) { 
while (true) { 
val info = UserInfo() 
info.rowid = cursor.getLong (0) 
info.xuhao = cursor.getInt (1) 
info .name = CUrSsSor.getString(2) 
info.age = cursor.getInt(3) 
info.height = cursor.getLong(4) 
info.weight = cursor.getFloat (5) 
//SQLite 没有 布尔 型 ， 用 0 表示 false， 用 1 表示 true 
info.married = if (cursor.getInt(6) == 0) false else true 
info.update time = cursor.getSstring(7) 
info.phone = cursor.getString(8) 
info.password = cursor.getstring(9) 
infoArray.add (info) 
if (cursor.isLast) { 
break 
} 


cursor.moveToNext () 
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} 


cursor.close() 


return infoArray 


// 根 据 手 机 号 码 查询 用 户 记 录 

fun queryByPhone (phone: String): UserInfo { 
val infoArray = query ("phone='$phone'") 
val info: UserInfo = if (infoArray.size>0) infoArray[0] else UserInfo() 
return info 


// 删 除 所 有 记录 
fun deleteAll(): Int = delete("1=1") 


// 获 取 所 有 记录 
fun queryAll(): List<UserInfo> = query("1=1") 
} 


因为 新 来 的 管理 类 ManagedSQLiteOpenHelper 来 自 于 Anko 库 ， 所 以 要 记得 在 UserDBHelper 
文件 头 部 加 入 下 面 一 行 导入 语句 : 
import org.jetbrains.anko.db.ManagedSQLiteOpenHelper 


另外 , 有 别 于 常见 的 anko-common 包 , Anko 库 把 跟 数 据 库 有 关 的 部 分 放 到 了 anko-sqlite 包 中 ， 
故而 还 需 修改 模块 的 build.gradle 文件 ， 在 dependencies 节点 中 补充 下 述 的 anko-sqlite 包 编 译 配置 : 


compile "org.jetbrains.anko:anko-sqlite:$anko version" 


现在 有 了 用 户 信 息 表 的 管理 类 , 在 Activity 代码 中 存 取 用 户 信息 就 方便 多 了 ,下 面 是 往 数据 库 
存储 用 户 信息 和 从 数据 库 读 取 用 户 信息 的 代码 片段 : 
var helper: UserDBHelper = UserDBHelper.getInstance (this) 
// 往 数据 库存 储 用 户 信息 
btn_save.setOnClickListener { 
when (true) { 
et_name .text.isEmpty() -> toast ("请 先 填写 姓名 ") 
et _age.text.isEmpty() -> toast ("请 先 填写 年 龄 ") 
et height.text.isEmpty() -> toast ("请 先 填写 身高 ") 
et_weight.text.isEmpty() -> toast ("请 先 填写 体重 ") 
else -> { 
val info = UserInfo (name = et name.text.tostring(), 
age = et age.text.toString() .toInt (), 
height = et height.text.toString().toLong(), 
weight = et weight.text.toSstring().toFloat(), 
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married = bMarried, 
update time = DateUtil.nowDateTime) 
helper.insert (info) 


toast ("数据 已 写 入 SQLite 数据 库 ") 


} 


// 从 数据 库 读 取 用 户 信息 
Private fun readSQLite() { 
val userArray = helper.queryAll() 
var desc = "数据 库 查询 到 $ {userArray .size} 条 记录 ， 详 情 如 下 : " 
for (i in userArray.indices) { 
Val item = userArray[i] 
desc = "$desc\n 第 ${i+1} 条 记录 信息 如 下 : " + 
"\n 姓名 为 ${item.name}" + 
"\n 年 龄 为 ${item.age}" + 
"\n 身高 为 ${item.height}" + 
"\n 体重 为 ${item.weight}" + 
"\n 婚 否 为 ${item.married}" + 
"An 更 新 时 间 为 ${item.update time}" 
} 
if (userArray.isEmpty()) { 
desc = "数据 库 查询 到 的 记录 为 空 " 
} 
tv_sqlite.text = desc 


以 上 代码 对 应 的 用 户 注册 信息 存 取 界面 如 图 8-5 和 图 8-6 所 示 ， 其 中 图 8-5 所 示 为 保存 用 户 注 
册 信 息 的 效果 图 ， 图 8-6 所 示 为 读 取 用 户 注册 信息 的 效果 图 。 








storage 


storage 


删除 所 有 记录 


数据 库 查 询 到 1 条 记录 ， 详 情 如 下 : 
第 1 条 记录 信息 如 下 : 
姓名 为 大 宝 
年 龄 为 30 
身高 为 175 
体重 为 70.0 
婚 否 为 true 
更 新 时 间 为 2017-11-02 15:04:48 








已 婚 
保存 到 数据 库 











图 8-5 把 注册 信息 保存 到 数据 库 图 8-6 ”从 数据 库 读 取 注 册 信息 
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8.2.3 ”优化 记 住 密码 功能 


在 前 面 的 “8.1.3 实现 记 住 密码 功能 ”一 节 ， 利 用 共享 参数 实现 了 记 住 密码 的 功能 。 可 是 这 个 
办 法 有 个 局 限 ,就 是 它 只 能 记 住 一 个 用 户 的 登录 信息 ,并 且 手 机 号 码 跟 密 码 不 存在 匹配 关系 ,如 果 
换个 手机 号 码 登 录 , 那么 前 一 个 用 户 的 登录 信息 就 被 覆盖 了 。 真正 意义 上 的 记 住 密码 功能 应 该 是 先 
输入 手机 号 码 , 然后 根据 手机 号 去 匹配 保存 的 密码 ,一 个 密码 对 应 一 个 手机 号 码 ， 如 此 方 能 实现 具 
体 号 码 的 密码 记忆 功能 。 

现在 通过 运用 数据 库 SQLite 分 条 存储 用 户 的 登录 信息 ， 另 外 提供 根据 手机 号 码 查找 登录 信息 
的 方法 ， 这 样 便 可 以 同时 记 住 多 个 手机 号 的 密码 。 倘 若 使 用 Java 编码 ， 则 具体 的 改造 点 主要 有 : 


(1) 声明 一 个 UserDBHelper 对 象 ， 然 后 在 onStart 方法 中 打开 数据 库 连 接 ， 在 onStop 方法 中 
关闭 数据 库 连接 ， 示 例 代码 如 下 : 


@Override 





protected void onStart() { 
super.onstart (); 
mHelper = UserDBHelper.getIinstance (this, 2); 
mHelper.openWriteLink(); 

3} 


@Override 
protected void onStop() { 
super.onStop(); 
mHelper.closeLink(); 
上 
(2) 登录 成 功 时 ， 如 果 用 户 色 选 了 “ 记 住 密码 ”， 就 使 用 数据 库 保存 手机 号 码 与 密码 在 内 的 
登录 信息 ， 即 在 loginSuccess 函数 中 增加 以 下 Java 代码 : 
if (bRemember) { 
UserInfo info = new UserInfo(); 
info.phone = et phone.getText () .toString(); 
info.password = et password.getText().toString(); 
info.update time = DateUtil.getNowDateTime ("yyyy-MM-dd HH:mm:ss"); 
mHelper.insert (info); 
| 


(3) 打开 登录 页 面 ， 用 户 输入 手机 号 完毕 ， 点 击 密码 输入 框 时 ，App 从 数据 库 中 根据 手机 号 
查找 登录 记录 ,并 将 记录 结果 中 的 密码 填 入 密码 框 。 为 了 实现 该 步骤 的 功能 , 需要 给 密码 框 注册 一 
个 焦点 变更 监听 器 ， 就 像 下 面 一 行 代码 那样 : 

et_ password.setOnFocusChangeListener (this); 


这 个 焦点 变更 监听 器 要 实现 接口 OnFocusChangeListener， 对 应 的 事件 处 理 方法 是 
onFocusChange， 那 么 把 数据 库 查 询 操作 放 在 该 方法 里 就 行 了 ， 详 细 的 Java 代码 如 下 所 示 : 
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@Override 
Public void onFocusChange (View v, boolean hasFocus) { 
String Phone = et phone.getText() .toString(); 
if (v.getId() == R.id.et password) { 
if (phone.length() > 0 && hasFocus == true) { 
UserInfo info = mHelper.queryByPhone (phone); 
if (info != null) { 
et password.setText (info.password); 
} 


} 
从 上 面 三 个 步骤 看 到 ， 第 一 个 步骤 的 打开 和 关闭 数据 库 连 接 其实 跟 业务 没什么 关系 ， 纯 粹 是 
装 门面 的 劳民伤财 之 举 。 现 在 借用 Kotlin 的 新 工具 ManagedSQLiteOpenHelper 完全 可 以 去 掉 数 据 
库 连接 的 步 又， 于 是 Kotlin 优化 后 的 密码 记 住 功能 实际 只 要 下 面 的 步骤 。 
人 Xi) 用 户 如 果 在 登录 页 面 勾 选 了 “ 记 住 密码 ”， 就 需 利 用 数据 库 保存 包括 手机 号 码 与 密码 在 
内 的 登录 信息 ， 具 体 的 Kotlin 代码 如 下 所 示 : 


if (bRemember) { 
val info = UserInfo (Phone = et _ phone.text.toString(), 
Password = et password.text.toString(), 
update time = DateUtil.nowDateTime) 
mHelper.insert (info) 
} 


CT02 如 果 用 户 上 次 登录 成 功 时 有 勾 选 “ 记 住 密码 ” 那么 下 次 打开 App 进入 登录 页 面 , 一旦 
有 户 将 手机 号 码 输 入 完毕 ，App 就 会 到 数据 库 找 出 与 之 匹配 的 密码 ， 并 自动 填 到 密码 框 中 。 下 面 是 实 
现 自动 匹配 密码 功能 的 Kotlin 代码 : 





湘 














et_password.setOnFocusChangeListener { v, hasFocus -> 
Val phone: String = et phone.text.toString() 
if (phone.isNotEmpty() && hasFocus) { 
val info = mHelper.queryByPhone (phone) 
et password.setText (info.password) 


} 


C03 代码 改 完了 , 再 来 看 看 登录 页 面 的 效果 图 ， 假 定 用 户 上 次 登录 成 功 时 选中 “ 记 住 密码 ” 
现在 再 次 进入 登录 页 面 。 如 图 8-7 所 示 ， 此 时 用 户 输入 手机 号 ， 光 标 还 停留 在 手机 框 ， 接 着 用 户 点 击 
密码 框 ， 光 标 随 之 跳 到 密码 框 ， 这 时 密码 框 自动 填 入 了 该 手机 号 对 应 的 密码 串 ， 如 图 8-8 所 示 。 
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storage storage 
@ 密码 登录 〇 验证 码 登录 @ 密码 登录 CO 〇 验证 码 登 录 
手机 号 码 : |1596023**** 手机 号 码 : 1596023 **** 
登录 密码 : 忘记 密码 登录 密码 : | 忘记 密码 
记 住 密码 口 记 住 密码 
登录 登录 
图 8-7 手机 号 码 输入 完毕 的 界面 图 8-8 根据 手机 号 自动 填写 密码 


8.3 文件 1/O 操作 


尽管 数据 库 能 够 存储 大 量 的 关系 型 数据 ， 可 它 不 是 万 能 的 ， 更 多 其 他 格式 的 数据 仍然 要 以 文 
件 形式 来 保存 。 尽 管 Java 的 文件 IO 功能 已 经 足够 强大 ， 然 而 美中不足 的 是 代码 写 起 来 很 哩 唆 ， 
仅仅 一 个 写 文件 或 者 读 文件 操作 都 要 通过 字 节 流 中 转 ， 编 程 新 手 往往 很 异 。 现 在 Kotlin 决心 革除 
旧 弊 ， 把 专业 的 文件 IO 处 理化 繁 为 简 ， 实 现 一 行 代码 即 可 完成 文件 读 写 操作 ， 赶 快 瞧 一 瞧 Kotlin 
为 新 手 们 共享 了 哪些 编程 福利 。 


8.3.1 文件 保存 空间 


手机 上 的 存储 空间 分 为 内 部 存储 和 外 部 存储 两 部 分 ， 内 部 存储 放 的 是 手机 系统 以 及 各 应 用 的 
安装 目录 ,外 部 存储 放 的 是 公共 文件 ， 如 图 片 、 文 档 、 音 视频 文件 等 。 早 期 的 外 部 存储 被 做 成 可 插 
拔 的 SD 卡 ， 然 而 用 户 自己 买 的 SD 卡 质量 参差 不 齐 ， 经 常会 影响 App 的 正常 运行 ， 所 以 后 来 越 来 
越 多 的 手机 把 SD 卡 固化 到 手机 内 部 ， 虽 然 拔 不 出 来 了 ， 但 是 Android 仍然 称 之 为 外 部 存储 。 由 于 
内 部 存储 空间 有 限 ， 因 此 为 了 不 影响 系统 的 流畅 运行 , App 运行 过 程 中 要 处 理 的 文件 都 保存 在 外 部 
存储 空间 。 

为 保证 App 正常 读 写 外 部 存储 ， 需 在 AndroidManifest.xml 中 增加 SD 卡 的 权限 配置 ， 具 体 的 
配置 信息 如 下 所 示 : 

<!-- SD 卡 读 写 权限 --> 

<uses-permission 
android:name="android.permission.WRITE EXTERNAL STORAGE" /> 

<uses-permission android:name="android.permission.READ EXTERNAL STORAG" 
/> 

<uses-permission 
android:name="android.permission.MOUNT UNMOUNT FILESYSTEMS" /> 
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本 来 有 了 上 面 的 权限 配置 ， 代 码 里 面 就 能 正常 读 写 SD 卡 的 文件 。 可 是 Android 从 7.0 开始 加 
强 了 SD 卡 的 权限 管理 , 即使 App 声明 了 完整 的 SD 卡 操作 权限 , 系统 仍然 默认 禁止 该 App 访问 外 
部 存储 。 打开 7.0 系统 的 设置 界面 , 进入 具体 应 用 的 管理 页 面 , 会 发 现 应 用 的 存储 功能 被 关闭 了 ( 指 
外 部 存储 ) ， 如 图 8-9 所 示 。 


《 Storage 


读 写 手 机 存储 


读 写 手 机 存储 





8-9 Android 7.0 手机 存储 的 权限 设置 界面 


不 过 系统 默认 关闭 存储 其 实 只 是 关闭 外 部 存储 的 公共 空间 ， 外 部 存储 的 私有 空间 依然 可 以 正 
常 读 写 。 这 是 缘 于 Android 把 外 部 存储 分 成 了 两 块 区 域 , 一块 是 所 有 应 用 均 可 访问 的 公共 空间 ， 男 


一 块 是 只 有 应 用 自己 才 可 访问 的 专 享 空间 。 之 前 说 过 ， 内 部 存储 保存 着 每 个 应 用 的 安装 目录 , 但 是 
安装 目录 的 空间 是 很 紧张 的 ， 所 以 Android 在 SD 卡 的 “Android/data” 目 录 下 给 每 个 应 用 又 单独 建 
了 一 个 文件 目录 , 用 于 给 应 用 保存 自己 需要 处 理 的 临时 文件 。 这 个 给 每 个 应 用 单独 建立 的 文件 目录 
只 有 当前 应 用 才能 够 读 写 文件 ， 其 他 应 用 是 不 允许 进行 读 写 的 ， 故 而 “Android/data ”目录 算是 外 
部 存储 上 的 私有 空间 。 这 个 私有 空间 本 身 己 经 做 了 访问 权限 控制 ,因此 它 不 受 系统 禁止 访问 的 影响 ， 
应 用 操作 自己 的 文件 目录 就 不 成 问题 了 。 当 然 ， 因 为 私有 的 文件 目录 只 有 属 主 应 用 才能 访问 ， 所 以 
一 旦 属 主 应 用 被 用 户 卸 载 ， 那 么 对 应 的 文件 目录 也 会 一 起 被 清理 掉 。 
既然 外 部 存储 分 成 了 公共 空间 和 私有 空间 两 部 分 ， 这 两 部 分 空间 的 路 径 获 取 也 就 有 所 不 同 。 

获取 公共 空间 的 存储 路 径 调用 的 是 Environment.getExternalStoragePublicDirectory 方法 , 获取 应 用 私 
有 空间 的 存储 路 径 调用 的 是 getExternalFilesDir 方法。 下 面 是 分 别 获 取 两 个 空间 路 径 的 Kotlin 代码 
例子 : 


class FilePathActivity : AppCompatActivity() { 





override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity file path) 
// 获 取 系 统 的 公共 存储 路 径 
val publicPath = Environment .getExternalStoragePublicDirectory 
(Environment .DIRECTORY DOWNLOADS) .toString(); 
// 获 取 当前 app 的 私有 存储 路 径 
val PrivatePath = getExternalFilesDir (Environment. 
DIRECTORY DOWNLOADS) .toString(); 
tv_file path.text = "系统 的 公共 存储 路 径 位 于 $ {publicPath}" + 
"\n\n 当前 App 的 私有 存储 路 径 位 于 $ {privatePath}" + 
"\n\nAndroid7.0 之 后 默认 禁止 访问 公共 存储 目录 " 
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该 例子 运行 之 后 获得 的 路 径 信息 如 图 8-10 所 示 ， 可 见 应 
用 的 私有 空间 路 径 位 于 “外 部 存储 根 目录 /Android/data/ 应 用 包 


» 系统 的 公共 存储 路 径 位 于 /storage/ 
名 /files/Download” 下。 emulated/0/Download 


storage 








stp 
-二 rn 一 二 storage/emulater ndroid/data 
8 。 3 e 2 读 与 了 本 文 件 com.example.storage/files/Download 


Android7.0 之 后 默认 禁止 访问 公共 存储 目录 
8-10 外 部 存储 的 两 种 访问 路 径 





Java 的 文件 处 理 用 到 了 io 库 java.io， 该 库 虽然 功能 强大 ， 
但 是 与 文件 内 容 的 交互 还 得 通过 输入 输出 流 中 转 , 致使 文件 读 
写 操作 颇 为 烦琐 。 因此 ， 开 发 者 通常 得 自己 重新 封装 一 个 文件 存 取 的 工具 类 ,以 便 在 日 常 开发 中 调 
用 。 下 面 是 一 个 文件 工具 类 的 简单 Java 代码 : 


public class FileUtil { 


// 保 存 文本 文件 
public static void saveText (String path, String txt) { 
tryat 
FileOutputStream fos = new FileOutputStream(path); 
fos .write (txt.getBytes ()) 7 
fos.close(); 
} catch (Exception e) { 
e.printStackTrace (); 
} 


// 读 取 文本 文件 

public static String openText (String path) { 
String readStr = ""; 
try { 


FileInputStream fis = new FileInputStream(path); 
byte[] b = new bytel[lfis.available()]; 
fis.read(b); 
readStr = new String(b); 
fis.close(); 

} catch (Exception e) { 
e.printStackTrace (); 

} 

return readSstr; 


} 

从 上 述 代码 看 到 ， 仅 仅 是 文本 文件 的 内 容 保存 和 读 取 ， 就 得 规 规矩 矩 写 这 么 多 行 代码 ， 并 且 
还 不 太 容 易 理解 ， 对 于 新 手 来 说 着 实 不 够 友好 。 哪 里 有 痛 点 ， 哪 里 就 有 优化 ， 所 以 Kotlin 在 文件 
API 这 块 也 下 了 一 番 功 夫 ， 它 以 Java 的 io 库 为 基础 ， 利 用 扩展 函数 的 功能 添加 了 一 些 常用 的 文件 
内 容 读 写 方法 ， 并 且 往往 是 一 行 代码 便 搞 定 功能 ， 绝 不 拖泥带水 。 








第 8 章 ”Kotlin 进行 数据 存储 | 225 


比如 把 一 段 文本 写 入 文本 文件 ， 只 要 调用 File 对 象 的 writeText 方法 ， 即 可 实现 写 入 文本 的 功 
能 。 真 的 只 要 一 行 代码 ， 就 像 下 面 这 样 : 
// 把 文本 写 入 文件 


File(file path) .writeText (Content) 


如 此 简洁 又 好 用 的 代码 ， 想 必 是 许多 开发 者 梦 宁 以 求 的 。 当 然 ，Kotlin 同样 支持 其 他 格式 的 数 
据 写 入 , 前 面 的 writeText 方法 是 覆盖 写 入 文本 , 若 要 往 源 文件 追加 文本 , 则 可 调用 appendText 方 法。 
看 过 了 文件 的 写 入 操作 ， 再 来 看 看 文件 的 读 取 操 作 。 有 了 writeText 方法 带好 头 ，Kotlin 又 提 
供 了 以 下 几 个 好 看 且 好 用 的 文件 内 容 读 取 方法 。 
@ readText: 读 取 文 本 形式 的 文件 内 容 。 
@ readLines: 按 行 读 取 文件 内 容 。 返 回 一 个 字符 串 的 List， 文 件 有 多 少 行 ， 队 列 中 就 有 多 少 个 
元 素 。 


这 几 个 方法 理解 起 来 毫 不 费力 ， 从 文件 中 读 取 全 部 的 文本 ， 也 只 要 下 面 一 行 代码 便 成 : 


// 读 取 文 件 的 文本 内 容 
val content = File(file path) .readText() 


下 面 演示 一 下 文本 文件 的 读 写 效果 ， 如 图 8-11 所 示 ，App 把 页 面 录入 的 注册 信息 保存 到 SD 
卡 上 的 文本 文件 ; 接着 进入 文件 列表 读 取 页 面 , 选中 某 个 文本 文件 , 页 面 就 展示 该 文件 的 文本 内 容 ， 
如 图 8-12 所 示 。 





删除 所 有 文本 文件 


文件 名 : 20171102150553.txt 


婚 否 : 未 婚 
注册 时 间 : 2017-11-02 15:05:53 


保存 文本 到 存储 卡 


用 户 注册 信息 文件 的 保存 路 径 为 : 
/storage/emulated/0/Android/data/ 
com.example.storage/files/Download/ 
20171102150553.txt 














图 8-11 把 注册 信息 保存 到 文本 文件 图 8-12 ”从 文本 文件 读 取 注 册 信息 


8.3.3 读 写 图 片 文件 


像 图 片 等 二 进 制 格式 的 文件 ， 可 通过 字 节 数组 的 形式 写 入 文件 ， Kotlin 提供 了 writeBytes 方法 
用 于 覆盖 写 入 字 节 数组 ， 也 提供 了 appendBytes 方法 用 于 追加 字 节 数组 。 不 过 由 于 图 像 存储 比较 特 
殊 ， 牵 涉 到 压缩 格式 与 压缩 质量 ， 因 此 还 得 通过 输出 流 来 处 理 〈 这 是 Bitmap 的 compress 方法 要 求 
的 ) ， 具 体 的 图 片 文 件 写 入 代码 如 下 所 示 : 
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fun saveImage (path: String, bitmap: Bitmap) { 
try { 
val file = File(path) 
//outputStream 获取 文件 的 输出 流 对 象 
//writer 获取 文件 的 Writer 对 象 
//printWriter 获取 文件 的 PrintWriter 对 象 
val fos: OutputStream = file.outputStream() 
// 压 缩 格 式 为 JPEG 图 像 ， 压 缩 质量 为 80% 
bitmap .compress (Bitmap .CompressFormat.JPEG，80，fos) 
fos.flush() 
fos.close() 
} catch (e: Exception) { 
e.printStackTrace () 
} 
} 


若 想 从 图 片 文件 中 读 取 位 图 信息 ， 按 上 面 的 writeBytes 使 用 说 明 ， 应 能 调用 readBytes 方法 。 
该 办 法 确实 可 行 ， 因为 Android 的 位 图 工厂 BitmapFactory 刚好 提供 了 decodeByteArray 函数 , 用 于 
从 字 节 数组 中 解析 位 图 ， 具 体 代 码 如 下 所 示 : 

// 方 式 一 : 利用 字 节 数组 读 取 位 图 

//readBytes 读 取 字 节 数组 形式 的 文件 内 容 

Val bytes = Filel(file path) .readBytes() 

//decodeByteArray 从 字 节 数组 解析 图 片 

val bitmap = BitmapFactory.decodeByteArray (bytes, 0, bytes.size) 

之 前 提 到 将 位 图 保存 为 图 片 文件 时 ， 通 过 输出 流 进行 处 理 ， 那 么 反 过 来 ， 从 图 片 文件 读 取 位 
图 数据 也 可 以 通过 输入 流 来 完成 。 当 然 ， 多 亏 了 BitmapFactory 的 decodeStream 方法 ， 使 得 输入 流 
解析 位 图 能 够 变 成 现实 ， 以 下 便 是 输入 流 方式 读 取 图 片 的 代码 例子 : 

// 方 式 二: 利用 输入 流 读 取 位 图 

//inputStream 获取 文件 的 输入 流 对 象 

val fis = File(file path) .inPputStream() 
//decodeStream 从 输入 流 解析 图 片 


val bitmap = BitmapFactory.decodeStream(fis) 
fis.close() 


前 两 种 读 取 图 片 文件 的 方式 其 实 都 包含 两 个 步骤 : 先 从 File 对 象 获得 文件 内 容 ， 再 利用 位 图 
工厂 解码 成 位 图 。 这 么 做 也 只 需 两 行 代码 , 但 是 不 如 读 取 文本 的 一 行 代码 来 得 精炼 ， 对 于 精益 求 精 
的 开发 者 来 说 ， 此 处 仍然 有 着 改善 的 空间 。 幸 好 位 图 工厂 留 了 一 手 终极 大 招 ， 名 叫 decodeFile， 只 
要 给 出 图 片 文件 的 完整 路 径 ， 文 件 读 取 和 位 图 解析 的 操作 都 一 齐 搞定 了 ， 有 具体 代码 如 下 : 

// 方 式 三 : 直接 从 文件 路 径 获 取 位 图 
//decodeFile 从 指定 路 径 解析 图 片 
val bitmap = BitmapFactory.decodeFile (file path) 


真是 想不到 ， 只 是 从 图 片 读 取 位 图 数据 这 个 小 功能 就 有 至 少 三 种 方式 ， 不 但 学 到 了 Kotlin 的 
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文件 读 取 API， 而 且 温 习 了 Android 的 BitmapFactory 工具 。 开 发 者 的 口味 各 不 相同 ， 无 论 个 人 偏 
好 哪 种 写法 ， 以 上 三 种 方式 总 有 一 款 适 合 你 。 

照例 演示 图 片 文件 的 读 写 结果 ， 如 图 8-13 所 示 ， 用 户 在 注册 页 面 录入 注册 信息 ，App 调用 
getDrawingCache 方法 把 整个 界面 截图 并 保存 到 SD 卡 ; 然后 在 另 一 个 页 面 的 图 片 列表 选择 SD 卡 
上 的 指定 图 片 文件 ， 页 面 就 展示 上 次 保存 的 截图 图 片 ， 如 图 8-14 所 示 。 





storage storage 


删除 所 有 图 片 文件 


20171102150643.png 





保存 图 片 到 存储 卡 





用 户 注册 信息 图 片 的 保存 路 径 为 : 
/storage/emulated/0/Android/data/ 
com.example.storage/files/Download/ 
20171102150643.png 








图 8-13 把 注册 信息 保存 到 图 片 文件 图 8-14 读 取 注册 信息 的 图 片 文件 


8.3.4 遍历 文件 目录 


写 文件 和 读 文件 是 处 理 单个 文件 ， 没 有 太 复 杂 的 需求 。 倘 若 要 求 遍历 某 个 目录 下 面 的 所 有 文 
本 文件 或 者 图 片 文件 ， 那 就 麻烦 了 ， 因 为 该 功能 的 需求 点 很 丰富 , 例如 要 不 要 到 子 目 录 和 孙子 目录 
下 搜索 、 文 件 跟 文 件 夹 都 要 匹配 还 是 只 匹配 其 中 之 一 、 筛 选 条 件 的 文件 扩展 名 都 有 哪些 。 想 想 这 些 
详细 的 功能 点 都 觉得 头 大 ， 就 算 好 不 容易 把 符合 条 件 的 文件 都 挑 出 来 ， 末了 还 得 再 来 一 个 for 循环 
进行 处 理 操作 。 如 果 遍 历 功能 采用 Java 编码 ， 新 手 绝对 无 法 自己 写 出 实现 代码 ， 饶 是 高 手 也 要 颇 
费 一 番 工 夫 。 
现在 有 了 Kotlin 就 方便 多 了 ， 因 为 Kotlin 把 目录 遍历 这 个 功能 重新 梳理 了 一 下 ， 归 纳 为 
FileTreeWalk 文件 树 ， 通 过 给 文件 树 设置 各 式 各 样 的 参数 与 条 件 即 可 化 繁 为 简 ， 轻 轻松 松 获取 文件 
的 搜索 结果 。 文 件 树 的 使 用 很 简单 ， 首 先 调用 File 对 象 的 walk 方法 得 到 FileTreeWalk 实例 ， 接 着 
依次 为 该 实例 设置 具体 的 条 件 , 包括 遍历 深度 、 是 否 匹 配 文件 夹 、 文 件 扩展 名 以 及 最 后 的 文件 队列 
循环 处 理 。 心 动 不 如 行动 ， 快 来 看 看 Kotlin 的 文件 遍历 是 怎么 实现 的 ， 下 面 是 搜寻 指定 目录 下 面 
所 有 文本 文件 的 示例 代码 : 
Var fileNames: MutableList<String> = mutableListof() 
// 在 该 目录 下 走 一 圈 ， 得 到 文件 目录 树 结构 
val fileTree: FileTreeWalk = File(mPath) .walk() 
fileTree.maxDepth (1) // 需 遍历 的 目录 层级 为 1， 即 无 须 检查 子 目录 
.filter { it.isFile } // 只 挑选 文件 ， 不 处 理 文件 夹 
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-filter { 让 .extension == "txt" } // 选 择 扩展 名 为 txt 的 文本 文件 
.forEach { fileNames.add(it.name) } // 循 环 处 理 符合 条 件 的 文件 


注意 到 以 上 代码 判断 文件 扩展 名 使 用 了 “itextension == "txt"”， 如 果 符 合 条 件 的 扩展 名 只 
一 个 还 好 办 , 如 果 符 合 条 件 的 扩展 名 有 多 个 又 该 如 何 是 好 ? 壁 如 , 图 片 文件 的 扩展 名 既 可 能 是 png， 
也 可 能 是 jpg， 此 时 若 用 传统 的 “或 ”语句 判断 固然 可 行 ， 但 并 不 雅 观 。 更 好 的 办 法 是 利用 Kotlin 
的 in 条 件 ， 即 判断 文件 的 扩展 名 是 否 位 于 扩展 名 队列 中 ， 形 如 “itextension in listOf("png","jpg")” 
这 样 ， 完 整 的 图 片 文件 搜索 代码 如 下 所 示 : 

var fileNames: MutableList<String> = mutableListof() 
// 在 该 目录 下 走 一 圈 ， 得 到 文件 目录 树 结构 
val fileTree: FileTreeWalk = File (mPath) .walk() 
fileTree.maxDepth (1) // 需 遍历 的 目录 层级 为 1， 即 无 须 检查 子 目录 
.filter { it.isFile } // 只 挑选 文件 不 处 理 文件 夹 
.filter { it.extension in listOf ("png", "jpg") } // 选 择 扩展 名 为 png 和 
jpg 的 图 片 文件 
.forEach { fileNames.add(it.name) } // 循 环 处 理 符 合 条 件 的 文件 

见识 了 Kotlin 强大 的 文件 操作 API， 真 让 人 耳目 一 新 ， 如 果 你 厌倦 了 Java 的 繁 文 拓 节 ， 不 妨 

来 Kotlin 这 里 小 试 身手 。 


8.4 Application 全 局 变量 


Application 是 安 卓 的 又 一 大 组 件 ， 它 的 生命 周期 连接 着 App 的 整个 运行 过 程 ， 因 此 开发 者 常 
常 给 自 定义 的 Application 运用 单 例 模式 ， 使 之 具备 全 局 变量 的 管理 功能 。 那 么 Kotlin 如 何 实现 
Application 的 单 例 化 处 理 ? 又 如 何 实现 全 局 变量 的 定义 和 使 用 ? 本 节 接 下 来 就 对 Application 的 这 
两 个 方面 进行 详细 的 介绍 。 


8.4.1 Application 单 例 化 


在 App 运行 过 程 中 ， 有 且 仅 有 一 个 Application 对 象 贯穿 应 用 的 整个 生命 周期 ， 所 以 适合 在 
Application 中 保存 应 用 运行 时 的 全 局 变量 。 而 开展 该 工作 的 基础 是 必须 获得 Application 对 象 的 唯 
一 实例 ， 也 就 是 将 Application 单 例 化 。 获 取 一 个 类 的 单 例 对 象 需要 运用 程序 设计 中 常见 的 单 例 模 
式 ， 通 过 Java 编码 实现 单 例 化 想必 早已 是 大 家 耳熟能详 的 了 。 下 面 便 是 一 个 Application 单 例 化 的 
Java 代码 例子 : 


public class MainApplication extends Application { 


Private static MainApplication mApp; 


public static MainApplication getInstance() { 
return mApp; 
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} 


@Override 

Public void onCreate() { 
Super .onCreate () 
mApp = this; 


} 

从 以 上 代码 可 见 ， 这 个 单 例 模式 的 实现 过 程 主要 有 三 个 步骤 ， 说 明 如 下 : 

人 EXOi 在 自 定义 的 Application 类 内 部 声明 一 个 该 类 的 静态 实例 。 

C02 重 写 onCreate 方法 ， 把 自身 对 象 赋值 给 第 一 步 声明 的 实例 。 

C03 提供 一 个 供 外 部 调用 的 静态 方法 getInstance， 该 方法 返回 第 一 步 声 明 的 Application 类 
实例 。 


无 论 是 代码 还 是 步骤 ， 这 个 单 例 化 的 实现 都 还 蛮 简 单 的。 同样 的 单 例 化 过 程 通过 Kotlin 编码 
实现 的 话 ， 静 态 属性 和 静态 方法 可 利用 伴生 对 象 来 实现 ， 这 样 就 形成 了 Kotlin 单 例 化 的 第 一 种 方 
式 : 手工 声明 属性 的 单 例 化， 具体 描述 如 下 。 


1. 手工 声明 属性 的 单 例 化 

该 方式 与 Java 的 常见 做 法 一 致 ， 也 是 手工 声明 自身 类 的 静态 实例 ， 然 后 通过 静态 方法 返回 自 
身 实 例 。 与 Java 的 不 同 之 处 在 于 ，Kotlin 引入 了 空 安全 机 制 ， 故 而 静态 属性 要 声明 为 可 空 变量 ， 
然后 获得 实例 时 要 在 末尾 加 上 双 感 叹 号 表示 非 空 ， 当 然 也 可 事先 将 自身 实例 声明 为 延迟 初始 化 属 
性 。 总 之 ， 两 种 声明 手段 都 是 为 了 确保 一 个 目的 ， 即 Application 类 提供 给 外 部 访问 的 自身 实例 必 
须 是 非 空 的 。 

下 面 是 手工 单 例 化 的 Kotlin 代码 例子 : 


class MainApplication : Application() { 



































override fun onCreate() { 
super.onCreate() 
instance = this 


// 单 例 化 的 第 一 种 方式 : 声明 一 个 简单 的 Application 属性 


companion object { 
// 情 况 一 : 声明 可 空 的 属性 
Private var instance: MainApplication? = null 
fun instance() = instance!! 
// 情 况 二 : 声明 延迟 初始 化 属性 
//private lateinit var instance: MainApplication 
//fun instance() = instance 
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2. 借助 Delegates 的 委托 属性 单 例 化 

第 一 种 方式 的 单 例 化 虽然 提供 了 两 种 属性 的 声明 手段 ， 但 只 是 为 了 保证 自身 实例 的 非 空 性 。 
如 果 仅 仅 是 确保 属性 非 空 ， 其 实 Kotlin 已 经 提供 了 一 个 系统 工具 进行 自动 校 验 ， 这 个 工具 便 是 
Delegates 的 notNull 方法 。 该 方法 返回 非 空 校 验 的 行为 ， 只 要 将 指定 属性 的 读 写 行为 委托 给 这 个 非 
室 校 验 行 为 , 开发 者 就 无 须 手工 进行 非 空 判 断 。 利用 Delegates 工具 的 属性 代理 功能 就 构成 了 Kotlin 
的 第 二 种 单 例 化 方式 。 有 关 委 托 属性 和 属性 代理 的 介绍 可 参考 前 面 的 “8.1.2 属性 代理 等 黑 科 技 ” 
三 区。 
下 面 是 利用 系统 代理 行为 实现 单 例 化 的 Kotlin 代码 例子 : 


class MainApplication : Application() { 


override fun onCreate() { 
super.onCreate() 
instance = this 
| 
// 单 例 化 的 第 二 种 方式 : 利用 系统 自 带 的 Delegates 生成 委托 属性 
companion object { 


Private var instance: MainApplication by Delegates.notNull () 
fun instance() = instance 


} 


第 二 种 方式 的 委托 属性 单 例 化 ， 在 App 代码 中 获取 Application 实例 与 第 一 种 方式 是 一 样 的 ， 
都 是 调用 “MainApplication.instance()” 这 个 函数 获得 Application 的 自身 实例 。 


3. 自 定义 代理 行为 的 单 例 化 

前 两 种 单 例 化 都 只 完成 了 非 空 校 验 ， 还 不 是 严格 意义 上 的 单 例 化 。 真 正 的 单 例 化 是 有 且 仅 有 
一 次 赋值 操作 ,尽管 前 两 种 单 例 化 并 未 实现 唯一 赋值 功能 , 不 过 在 大 多 数 场合 已 经 够 用 了 。 可 是 作 
为 孜孜 不 倦 的 开发 者 , 务必 要 究 根 问 底 , 到 底 能 不 能 实现 唯一 赋值 情况 下 的 单 例 化 ? 显然 系统 自 带 
的 Delegates 工具 没有 提供 大 家 期 待 的 校 验 行为 ， 于 是 开发 者 必须 自己 写 一 个 能 够 校 验 赋值 次 数 的 
行为 类 ， 目 的 是 接管 委托 属性 的 读 写 行为 。 关 于 自 定义 接管 行为 的 实现 ， 本 章 一 开头 的 “8.1.1 共 
享 参数 读 写 模 板 Preference” 已 给 出 了 Preference<T> 的 完整 源码 ， 其 中 关键 是 重 写 读 方法 getValue 
和 写 方法 setValue， 因 此 在 这 里 可 借鉴 Preference<T> 完 成 自 定义 的 委托 行为 编码 。 

下 面 是 自 定义 代理 行为 的 单 例 化 代码 : 

class MainApplication : Application() { 


override fun onCreate() { 
super.onCreate() 
instance = this 


| 
// 单 例 化 的 第 三 种 方式 : 自 定义 一 个 非 空 且 只 能 一 次 性 赋值 的 委托 属性 


companion object { 
Private var instance: MainApplication by NotNullSingleValueVar() 
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fun instance () = instance 


// 定 义 一 个 属性 管理 类 ， 进 行 非 空 和 重复 赋值 的 判断 
Private class NotNullSingleValueVar<T>() : ReadWriteProperty<Any?, T> { 
Private var value: T? = null 
override fun getValue (thisRef: Any?, property: KProperty<*>): T { 
return value ?: throw IllegalStateException("application not 
initialized") 
1 
Override fun setValue (thisRef: Any?, property: KProperty<*>, value: T) { 
this.value = if (this.value == null) value 
else throw IllegalStateException ("applicationalready initialized") 


} 


由 上 述 代码 看 到 ， 自 定义 的 代理 行为 在 getValue 方法 中 进行 非 空 校 验 ， 在 setValue 方法 中 进 
行 重复 赋值 的 校 验 ， 从 而 按照 要 求 接管 了 委托 属性 的 读 写 行为 。 





8.4.2 利用 Application 实现 全 局 变量 


8.4.1 小 节 介绍 了 如 何 实现 Application 对 象 的 单 例 化 ,一 旦 有 了 单 例 的 Application 对 象 ， 就 意 
味 着 App 在 运行 过 程 中 获取 的 Application 实例 是 唯一 的 ， 因 此 可 在 该 实例 内 部 声明 几 个 静态 成 员 
变量 ， 从 而 形成 所 谓 的 全 局 变量 。 全 局 的 意思 就 是 其 他 代码 都 可 以 引用 该 变量 ， 因 此 全 局 变量 是 共 
享 数据 和 传递 消息 的 好 帮手 。 

适合 在 Application 中 保存 的 全 局 变量 主要 有 下 面 几 类 数据 : 

(1) 会 频繁 读 取 的 信息 ， 例 如 用 户 名 、 手 机 号 等 。 

(2) 从 网 络 上 获取 的 临时 数据 ， 为 节约 流量 ， 也 为 减少 用 户 等 待 时 间 ， 想 暂时 放 在 内 存 中 供 
下 次 使 用 ， 例 如 应 用 logo、 商 品 图 片 等 。 

(3) 容易 因 频 繁 分 配 内 存 而 导致 内 存 泄漏 的 对 象 ， 例 如 处 理 器 Handler、 线 程 池 ThreadPool 等 。 

要 想 通过 Application 实现 全 局 变量 的 读 写 ， 得 完成 以 下 几 个 步骤 : 

E301 写 一 个 类 MainApplication 继承 自 Application， 该 类 要 采用 单 例 模式 ， 内 部 声明 自身 的 
一 个 静态 单 例 对 象 ， 在 创建 App 时 把 自身 赋值 给 这 个 静态 实例 ， 然 后 提供 一 个 访问 该 静态 对 象 的 
instance 函数 。 

本 B02 在 Activity 中 调用 MainApplication 的 instance 方法 ， 获 得 MainApplication 的 一 个 静态 
对 象 ， 便 可 通过 该 对 象 访问 MainApplication 的 公共 变量 和 公共 方法 。 

人 3 不 要 忘 了 在 AndroidManifestxml 中 注册 新 定义 的 Application 类 名 ， 即 在 application 节 
点 中 增加 android:name 属性 ， 其 值 为 "MainApplication"， 注 册 信息 举例 如 下 : 
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<application 
android:name=" .MainApplication" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app name" > 


下 面 演 示 Application 的 全 局 变量 读 写 效果 ， 如 图 8-15 所 示 ，App 把 注册 信息 保存 到 
MainApplication 的 全 局 变量 中 ;然后 在 另 一 个 页 面 ， 又 从 MainApplication 的 全 局 变量 中 读 取 之 前 
保存 的 注册 信息 ， 如 图 8-16 所 示 。 








全 局 内 存 中 保存 的 信息 如 下 : 
name 的 取 值 为 老 刘 
age 的 取 值 为 50 
height 的 取 值 为 165 
weight 的 取 值 为 60 
married 的 取 值 为 已 婚 
update_time 的 取 值 为 2017-11-02 

15:08:11 

















保存 到 全 局 内 存 


图 8-15 把 注册 信息 保存 到 全 局 变量 图 8-16 ”从 全 局 变量 读 取 注册 信息 


8.5 ”实战 项 目 : 电 商 App 的 购物 车 


购物 车 的 应 用 面 很 广 ， 凡 是 电 商 App 都 可 以 看 到 它 的 身影 ， 这 里 选中 购物 车 作为 本 章 的 实战 
项 目 ， 除 了 它 使 用 广泛 的 特点 外 ， 更 是 因为 它 用 到 了 多 种 存储 方式 。 现 在 就 让 我 们 开启 电 商 购物 车 
的 体验 之 旅 吧 。 


8.5.1 需求 描述 


先 来 看 看 常见 的 购物 车 长 什么 模样 ， 第 一 次 进入 购物 车 频道 ， 购 物 车 里 面 是 空 的 ， 如 图 8-17 
所 示 。 接 着 去 商场 频道 选 购 手机 ， 随 便 挑选 几 部 手机 加 入 购物 车 ,然后 返回 购物 车 页 面 ， 即 可 看 到 
车 里 的 商品 列表 ， 如 图 8-18 所 示 ， 有 商品 图 片 、 名 称 、 数 量 、 单 价 、 总 价 等 信息 。 当 然 ， 购 物 车 
并 不 只 是 展示 代购 商品 ， 还 要 支持 最 终 购 买 的 结算 操作 、 删 除 不 想 要 的 商品 、 清 空 购物 车 等 功能 。 

购物 车 的 存在 感 是 很 强 的 ， 并 不 仅仅 在 购物 车 页 面 才能 看 到 购物 车 。 往 往 在 商场 频道 ， 甚 至 
某 个 商品 详情 页 面 , 都 会 看 到 某 个 角落 冒 出 个 购物 车 图 标 。 一 旦 有 新 商品 加 入 购物 车 ,那么 购物 车 
图 标 上 的 商品 数量 立马 加 一 。 当 然 , 用 户 也 可 以 点 击 购物 车 图 标 直接 跳 转 到 购物 车 页 面 。 如 图 8-19 
所 示 , 商场 频道 除了 商品 列表 之 外 , 页 面 右 上 角 还 有 一 个 购物 车 图 标 , 这 个 图 标 有 时 在 页 面 右上 角 ， 
有 时 在 页 面 右 下 角 , 总 之 会 有 一 个 地 方 存放 购物 车 图 标 。 商 品 详情 页 面 通常 也 有 购物 车 图 标 ， 如 图 
8-20 所 示 ， 倘 若 用 户 在 详情 页 面 把 商品 加 入 购物 车 ， 那 么 图 标 上 的 数字 也 会 加 一 。 
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4 购物 车 SA 


图 上 名 称 数量 单价 ”总 价 


“Mate'0 

a 2 3999 7998 
.ess 

ce Sm (下 


iPhone8 


哎呀 ， 购 物 车 空空 如 也 ， 快 去 选 购 商品 吧 


Apepoea 1 6888 6888 
255GB 下 更 全 色 入 动 
下 通信 4G 手 机 


小 米 6 
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图 8-17 首次 打开 购物 车 页 面 图 8-18 选 购 商品 后 的 购物 车 


至 此 ， 大 概 过 了 一 遍 购物 车 需要 实现 的 基本 功能 ， 提 需求 总 是 很 简单 的 ， 真 正 落 到 实处 还 得 
开发 者 发 挥 想象 力 ， 把 购物 车 做 成 一 个 功能 完备 的 模块 。 




















[4 手机 商场 NS 小 米 6 \53 
iPhone8 Mate10 
{= 
2 ” 国 
6888 加 入 购物 车 3999 
小 米 6 i R1 于 
2999 。 加 入 购物 车 。 2899 。 加 入 购物 车 2999 
vvo X9S 购 族 Pro6S 小 米 MI6 全 网 通 版 6GB+128GB 亮 白 色 
mr 一 r 二 加 入 购物 车 
图 8-19 手机 商场 频道 页 面 图 8-20 手机 商品 详情 页 面 


8.5.2 ”开始 热身 : 选项 菜单 OptionsMenu 


之 前 的 章节 在 进行 某 项 控制 操作 时 ， 一 般 是 由 按钮 控件 触发 。 如 果 页 面 上 需要 支持 多 个 控制 
操作 ， 比 如 去 商场 购物 、 清 空 购物 车 、 查 看 商品 详情 、 删 除 指定 商品 等 ， 就 得 往 页 面 上 添加 多 个 按 
钮 。 如 此 一 来 ，App 页 面 显 得 杂乱 无 章 ， 满 屏 的 按钮 既 碍 眼 又 不 便 操作 。 这 时 ， 就 要 请 选项 菜单 
OptionsMenu 来 帮忙 了 。 选 项 菜单 平时 不 显示 在 界面 上 ， 只 有 在 用 户 按 下 手机 右 下 和 角 的 菜单 键 , 或 
者 按 下 工具 栏 右上 角 的 三 点 键 时 ， 才 会 弹出 一 个 菜单 列表 供用 户 选 择 操 作 。 

若 要 实现 选项 菜单 的 功能 ,首先 要 定义 一 个 菜单 的 布局 文件 , 就 像 每 个 Activity 页 面 都 有 一 个 
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布局 文件 一 样 。 不 同 的 是 ， 页 面 的 布局 文件 放 在 res/layout 目录 下 ， 而 菜单 的 布局 文件 放 在 res/menu 
目录 下 。 下面 是 一 个 菜单 布局 文件 menu_option.xml 的 例子 , 很 简单 , 就 是 menu 与 item 的 组 合 排列 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android" > 


<item 
android:id="@+id/menu change time" 
android:orderInCategory="1" 
android:title=" 改 变 时 间 "/> 


<item 
android:id="@+id/menu change color" 
android:orderInCategory="8" 
android:title=" 改 变 颜色 "/> 


<item 
android:id="@+id/menu change bg" 
android:orderInCategory="9" 
android:title=" 改 变 背 景 "/> 
</menu> 


有 了 上 面 的 菜单 描述 布局 ， 接 着 在 Activity 代码 中 重 写 onCreateOptionsMenu 方法 ， 指 定 当 前 
页 面 加 载 该 菜单 布局 。 加 载 菜单 布局 的 Kotlin 代码 如 下 所 示 : 


override fun onCreateOptionsMenu (menu: Menu): Boolean { 
menuInflater.inflate(R.menu.menu_option，menu) 
return true 


有 


最 后 ， 重 写 Activity 代码 里 面 的 onOptionsItemSelected 方法 ， 对 各 个 菜单 项 进行 对 应 的 分 支 处 
理 。 下 面 是 一 个 对 选项 菜单 列表 做 多 路 分 支 的 Kotlin 代码 例子 : 


override fun onOptionsItemSelected (item: MenuItem) : Boolean { 
when (item.itemId) { 
R.id.menu change time -> setRandomTime () 
R.id.menu_change_color -> tv_option.setTextColor (randomColor) 
R.id.menu change bg -> tv_option.setBackgroundColor (randomColor) 
} 


return true 


private fun setRandomTime() { 
val desc = "${DateUtil.nowDateTime} 这 里 是 菜单 显示 文本 " 
tv_option.text = desc 


Private val mColorArray = intArrayOf (Color.BLACK, Color.WHITE, Color.RED, 
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Color.YELLOW, Color.GREEN, Color.BLUE, Color.CYAN, Color.MAGENTA, Color.GRAY, 
Color .DKGRAY) 
Private val randomColor: Int 
get() { 
val random = (Math.random() * 10 % 10) .toInt() 
return mColorArray[random] 


} 
代码 书写 完毕 ， 即 可 按 下 右 下 角 的 菜单 键 ， 也 可 按 下 右上 角 的 三 点 键 ， 这 两 种 方式 均 会 弹出 
选项 菜单 。 二 者 不 同 的 是 ， 菜 单 键 在 屏幕 下 方 弹出 菜单 列表 ， 如 图 8-21 所 示 ; 而 三 点 键 在 屏幕 右 
上 方 弹出 菜单 列表 ， 如 图 8-22 所 示 。 


改变 时 间 pe ewes 


Em 3 





二 号 
改变 背景 2017-11-02 15.0 发 诊 景 


图 8-21 按 菜单 键 弹出 菜单 列表 图 8-22 按 三 点 键 弹出 菜单 列表 


8.5.3 ”控件 设计 


首先 来 找 找 看 ， 购 物 车 到 底 采取 了 哪些 存储 方式 。 

@ ”数据库 SQLite: 最 直观 的 肯定 是 数据 库 了 ， 购 物 车 里 的 商品 列表 一 定 是 放 在 SQLite 中 的 ， 
增删 改 查 都 少不了 它 。 

@ ”共享 参数 SharedPreferences: 注意 到 不 同 页 面 右上 角 的 购物 车 图 标 都 有 数字 ， 表 示 购 物 车 中 
的 商品 数量 ， 这 个 商品 数量 建议 保存 在 共享 参数 中 。 因 为 每 个 页 面 都 要 显示 商品 数量 ， 如 果 
每 次 都 到 数据 库 中 执行 count 操作 ， 就 会 很 消耗 资源 。 并 且 商 品 数 量 需 要 持久 化 存储 ， 所 以 
不 适合 放 在 全 局 内 存 中 ， 不 然 下 次 启动 App， 内 存 中 的 变量 又 是 从 0 开始 。 

e@ SD 卡 文件 : 通常 情况 下 ， 商 品 图 片 来 自 于 电 商 平台 的 服务 器 ， 这 年 头 流量 是 很 宝贵 的 ， 可 
是 图 片 恰 恰 很 耗 流量 (尤其 是 大 图 )， 于 是 从 用 户 的 钱包 着 想 ，App 得 把 好 不 容易 下 载 来 的 图 
片 保存 在 SD 卡 。 这 样 一 来 ， 下 次 用 户 再 访问 商品 详情 页 面 时 ，App 便 能 直接 从 SD 卡 获取 
商品 图 片 ， 不 但 不 花费 流量 而 且 加 快 浏览 速度 ， 一 举 两 得 。 

”全 局 内 存 : 访问 SD 卡 的 图 片 文件 固然 是 个 好 主意 ， 然 而 像 商场 频道 、 购 物 车 频道 都 有 可 能 
在 一 个 页 面 上 展示 多 张 商品 小 图 ， 如 果 每 张 小 图 都 要 访问 SD 卡 ， 频 繁 的 SD 读 写 操作 也 变 
耗资 源 的 。 更 好 的 办 法 是 把 商品 小 图 加 载 进 全 局 内 存 ， 这 样 直接 从 内 存 中 获取 图 片 ， 高 效 又 
快速 。 之 所 以 不 把 商品 大 图 也 放 入 全 局 内 存 ， 是 因为 大 图 很 耗 空间 ， 一 不 小 心 便 会 占用 几 十 
兆 内 存 。 


然后 考虑 一 下 几 个 页 面 的 排版 布局 ， 主 要 用 到 Android 的 以 下 几 个 控件 。 


@ 工具 栏 Toolbar: 购物 车 、 商 场 频道 、 商 品 详情 这 几 个 页 面 需要 统一 风格 ， 故 界面 顶部 采取 
Toolbar 作为 整体 的 导航 栏 。 
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日 列表 视图 ListView: 购物 车 中 的 商品 列表 从 上 到 下 依次 排列 ， 适 合 使 用 ListView 来 展示 商品 
列表 。 

@ ”网 格 视图 GridView: 商场 频道 页 面 的 商品 陈列 橱柜 ， 通 过 GridView 能 够 最 大 限度 地 利用 屏 
幕 空间 。 

@ ”循环 视图 RecyclerView: 无 论 是 ListView 还 是 GridView， 都 存在 着 记录 项 点 击 与 内 部 控件 点 
击 的 冲突 问题 ， 因 此 最 好 采用 RecyclerView 代替 ListVIew 和 GridView。 

”选项 菜单 OptionsMenu: 购物 车 页 面 除了 展示 商品 列表 外 ， 还 要 支持 前 往 商 场 频道 、 清 空 购 
物 车 、 返 回 上 个 页 面 等 功能 。 要 是 这 些 功 能 都 使 用 按钮 操作 ， 势 必 弄 得 页 面 拥挤 不 堪 ， 所 以 
要 做 成 菜单 列表 形式 ， 在 用 户 需要 的 时 候 再 在 界面 上 弹出 菜单 ， 这 个 菜单 列表 的 弹出 效果 如 
图 8-23 所 示 。 

@ ”提醒 对 话 框 AlertDialog: 若 要 删除 购物 车 中 的 指定 商品 ,可 通过 监听 长 按 事件 来 触发 。 当 然 ， 
为 了 避免 用 户 误 操作 ， 对 于 长 按 事件 需要 弹出 提示 框 ， 好 让 用 户 确认 是 否 真 的 取消 购买 该 商 
品 ， 提 示 框 的 显示 效果 如 图 8-24 所 示 。 只 有 用 户 确定 不 再 购买 商品 ， 方 可 从 购物 车 列表 删除 
该 商品 。 


商品 购买 提示 


尊敬 的 用 户 ， 您 是 否 不 再 购买 


iPhone8? 


我 再 想 想 





图 8-23 ”购物 车 页 面 的 菜单 列表 图 8-24 ”取消 购买 商品 的 提示 框 


8.5.4 ”关键 代码 


为 了 方便 读者 更 好 、 更 快 地 使 用 Kotlin 编码 完成 购物 车 项 目 ,下 面 列举 几 个 重要 功能 的 Kotlin 
代码 片段 。 


1. 关于 页 面 跳 转 
因为 购物 车 页 面 允许 直接 跳 到 商场 频道 页 面 ， 并 且 商 场 频道 页 面 也 允许 跳 到 购物 车 页 面 ， 所 
以 如 果 用 户 在 这 两 个 页 面 之 间 跳 来 跳 去 , 然后 按 返 回 键 , 就 会 发 现 返回 的 时 候 也 会 在 这 两 个 页 面 间 
往返 跳 转 。 造 成 该 问题 的 原因 是 : 每 次 启动 活动 页 面 都 往 活动 栈 加 入 一 个 新 活动 , 那么 返回 出 栈 时 ， 
也 只 好 一 个 一 个 活动 依次 退出 了 。 
解决 该 问题 的 办 法 参见 第 6 章 的 “6.4.3 跳 转 时 指定 启动 模式 ”， 对 于 活动 跳 转 需要 指定 标志 
FLAG_ACTIVITY_ CLEAR_TOP, 表示 活动 栈 有 且 仅 有 该 页 面 的 唯一 实例 , 如 此 即 可 避免 多 次 返回 
同一 页 面 的 情况 。 若 是 利用 Kotlin 设置 这 个 启动 标志 ， 则 可 调用 clearTop 方法 予以 实现 ， 下 面 是 
两 个 页 面 之 间 跳 转 的 Kotlin 代码 例子 : 
// 在 购物 车 页 面 跳 到 商场 频道 页 面 ， 通 过 clearTop 函数 设置 启动 标志 
btn_shopping channel.setOnClickListener { 
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startActivity(intentFor<ShoppingChannelActivity>() .clearTop ()) 
// 在 商场 频道 页 面 跳 到 购物 车 页 面 ， 通 过 clearTop 函数 设置 启动 标志 
iv cart.setOnClickListener { 
startActivity(intentFor<ShoppingCartActivity>() .clearTop () ) 


2. 关于 菜单 列表 
考虑 到 用 户 使 用 习惯 ， 建 议 把 选项 菜单 功能 集成 到 工具 栏 上 面 ， 也 就 是 在 工具 栏 右 侧 展示 系 
统 自 带 的 竖 排 三 点 键 。 一旦 用 户 点 击 三 点 键 ， 就 在 屏幕 右上 角 弹 出 菜单 列表 供用 户 选择 ， 此 时 选项 


菜单 又 称 为 溢出 菜单 OverflowMenu， 意 思 是 导航 的 工具 栏 不 够 放 了 ， 溢 出 来 了 。 
下 面 是 溢出 菜单 的 菜单 布局 例子 ， 暂 时 包含 三 个 菜单 项 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android" > 


<item 
android:id="@+id/menu shopping" 
android:orderInCategory="1" 


android:title=" 去 商场 购物 "/> 


<item 
android:id="@+id/menu clear" 
android:orderInCategory="2" 


android:title=" 清 空 购物 车 "/> 


<item 
android:id="@+id/menu return" 
android:orderInCategory="9" 
android:title=" 返 回 "/> 
</menu> 


与 该 菜单 布局 对 应 的 Kotlin 响应 菜单 项 的 点 击 代码 如 下 所 示 : 


override fun onCreateOptionsMenu (menu: Menu): Boolean { 
menuInflater.inflate(R.menu.menu cart, menu) 


return true 


override fun onOptionsItemSelected(item: MenuItem) : Boolean { 
when (item.itemId) { 
R.id.menu shopping -> startActivity(intentFor< 
ShoppingChannelActivity>().clearTop()) 

R.id.menu clear -> { 
mCartHelper .deleteAll () // 清 空 购物 车 数据 库 
showCount (0) 
toast (" 购 物 车 已 清空 ") 
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R.id.menu return -> finish() 
} 
return true 


3. 关于 商品 图 片 的 缓存 

通常 ， 商 品 图 片 由 后 端 服务 器 提供 ，App 打开 页 面 时 再 从 服务 器 下 载 所 需 的 商品 图 。 可 是 购 
物 车 模块 的 多 个 页 面 都 会 展示 商品 图 片 ， 如 果 每 次 都 到 服务 器 加 载 图 片 ， 显 然 既 耗 时 间 又 耗 流量 ， 
非常 不 经 济 。 因 此 ，App 开发 会 把 常用 的 图 片 进行 缓存 处 理 ， 图 片 一 旦 从 服务 器 下 载 成 功 ， 便 在 手 
机 存储 空间 上 保存 图 片 文件 。 然 后 下 次 界面 需要 加 载 商品 图 片 时 ， 就 先 从 手机 寻找 该 图 片 ， 如 果 找 
到 ， 就 读 取 图 片 的 位 图 信息 ， 否 则 再 到 服务 器 下 载 图片 。 

以 上 的 缓存 逻辑 是 最 简单 的 二 级 缓存 ， 实 际 开发 往往 使 用 更 高 级 的 三 级 缓存 机 制 ， 即 “运行 
内 存 一 外 部 存储 (SD 卡 ) 一 网 络 下 载 ”。 其 中 ， 和 运行 内存 的 速度 快 但 容量 小 ， 所 以 更 适合 存放 频 
繁 访问 的 商品 小 图 ; 而 SD 卡 速度 稍 慢 但 容量 大 ， 所 以 适合 存放 不 太 经 常 访问 的 商品 大 图 。 按 此 思 
路 构建 购物 车 的 商品 图 片 缓存 框架 ， 对 应 的 Kotlin 代码 示例 如 下 : 


companion object { 
// 模 拟 网 络 数据 ， 初 始 化 数据 库 中 的 商品 信息 
fun downloadGoods (ctx: Context, isFirst: String, helper: GoodsDBHelper) { 
val path = MainApplication.instance() .getExternalFilesDir 
(Environment .DIRECTORY DOWNLOADS) .toString() + "/" 
Log.d(TAG, "path=$path") 
if (isFirst == "true") { 
val goodsList = GoodsInfo.defaultList 
for (i in goodsList.indices) { 
val info = goodsList([i] 
val rowid = helper.insert (info) 
info.rowid = rowid 
// 往 运行 内 存 写 入 商品 小 图 
val thumb = BitmapFactory.decodeResource (ctx.resources, 
info.thumb) 
MainApplication.instance() .mIconMap.put (rowid, thumb) 
val thumb path = "$path$ {rowid}_s.jpg" 
FileUtil.saveImage (thumb path, thumb) 
info.thumb path = thumb path 
// 往 sD 卡 保存 商品 大 图 
Val pic = BitmapFactory.decodeResource (ctx.resources, 
info.pic) 
val pic path = "$path$ {rowid} .jpg" 
FileUtil.saveImage (pic path, pic) 
pic.recycle() 
info.pic path = pic path 
helper .update (info) 
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} 
} else { 

val goodsArray = helper.queryAll () 

for (item in goodsArray) { 
Log.d(TAG, "rowid=${item.rowid}, thumb path= 

${item.thumb path}") 

val thumb = BitmapFactory.decodeFile (item.thumb path) 
MainApplication.instance() .mIconMap.put (item.rowid, thumb) 


} 


4. 关于 购物 车 的 商品 列表 

虽然 商品 列表 看 起 来 很 适合 运用 列表 视图 ListView， 但 实际 上 采取 循环 视图 RecyclerView 更 
为 合适 。 其 中 的 缘由 是 RecyclerView 功能 更 强大 、 画 面 更 柔和 ， 而 且 循环 适配器 的 Kotlin 编码 更 
简单 。 下 面 是 一 个 购物 车 列表 的 Kotlin 适配器 代码 例子 : 


class RecyclerCartAdapter (context: Context, private val carts: 
MutableList<CartInfo>) : RecyclerBaseAdapter<RecyclerView.ViewHolder> (context) { 


override fun getItemCount () : Int = carts.size 


override fun onCreateViewHolder (Parent: ViewGroup, viewType: Int) : 
ViewHolder { 
val view: View = inflater.inflate(R.layout.item recycler cart, parent, 
false) 
return ItemHolder (view) 


override fun onBindViewHolder (holder: ViewHolder, position: Int) { 
val vh: ItemHolder = holder as ItemHolder 
vh.bind(carts[position], itemClickListener, itemLongClickListener) 


class ItemHolder (override val containerView: View?) : RecyclerView. 
ViewHolder (containerView), LayoutContainer { 
fun bind(item: CartIinfo, 
clickListener: RecyclerExtras.OnIitemClickListener?, 
longClickListener: RecyclerExtras.OnItemLongClickListener?) { 
iv thumb.setImageBitmap (MainApplication.instance(). 
mIconMap[item.goods id]) 
tv_name.text = item.goods.name 
tv_desc.text = item.goods.desc 
tv_count.text = item.count.toString() 
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tv Price.text = item.goods.Price.toString() 

tv_sum.text = (item.count * item.goods.Price) .上 toString() 

// 列表 项 的 点 击 事件 需要 自己 实现 

11 item.setOnClickListener { V -> 
clickListener?.onItemClick(v, position) 

1 

11 item.setOnLongClickListener { v -> 
longClickListener?.onItemLongClick(v, position) 
true 


} 


5. 关于 长 按 事件 的 提示 框 
这 个 提示 框 采取 Anko 库 提供 的 alert 扩展 函数 ， 可 有 效 缩小 代码 数量 ， 同 时 增强 代码 可 读 性 。 
使 用 alert 方 法 的 Kotlin 代码 例子 如 下 所 示 : 


override fun onItemLongClick(view: View, position: Int) { 
val cart = mCartArray [position] 
val message = "尊敬 的 用 户 ， 您 是 否 不 再 购买 ${cart .goods.name}?" 
alert (message，" 商 品 购买 提示 ") { 
PositiveButton (" 不 再 购买 ") { 
// 从 购物 车 删除 商品 的 数据 库 操作 
mCartHelper.delete("goods_id=" + cart.goods_id) 
// 更 新 购物 车 中 的 商品 数量 
showCount (mCount - cart.count) 
toast ("已 从 购物 车 删除 $ {cart .goods.name}") 
// 刷 新 购物 车 的 商品 列表 
showCart () 
} 
negativeButton ("我 再 想 想 ") { } 
}.show() 


8.6 小 结 





本 章 主要 介绍 了 Kotlin 操作 Android 的 几 种 数据 存储 方式 ， 包 括 利用 Preference<T> 实 现 共享 
参数 的 键 值 对 信息 存 取 、 利用 ManagedSQLiteOpenHelper 实现 更 安全 的 数据 库 记 录 管 理 、 通 过 全 新 
的 文件 IO 函数 库 简 化 文件 处 理 、Application 组 件 的 单 例 化 及 全 局 变量 的 实现 。 最 后 设计 了 一 个 实 
战 项 目 “ 电 商 App 的 购物 车 ”， 通 过 该 项 目的 编码 ， 进 一 步 复习 巩固 了 本 章 4 种 存储 方式 的 使 用 ， 
另外 介绍 了 选项 菜单 的 基本 用 法 。 
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通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 5 种 开发 技能 : 
(1) 学 会 利用 工具 类 Preference<T> 进 行 共享 参数 的 键 值 对 管理 工作 ， 并 人 掌握 委托 属性 、lazy 
修饰 符 、with 函数 的 基本 用 法 。 
(2) 学 会 使 用 Kotlin 的 ManagedSQLiteOpenHelper 工具 进行 数据 库 操 作 编码 。 


(3) 学 会 通过 Kotlin 的 文件 IO 函数 库 进 行文 件 相关 处 理 ， 包 括 文本 文件 读 写 、 图 片 文件 读 
写 、 文 件 目录 遍历 等 。 

(4) 学 会 按照 Kotlin 的 编码 风格 实现 Application 的 单 例 化 ， 并 通过 单 例 Application 操作 全 
局 变量 。 

(5) 学 会 Kotlin 编码 实现 选项 菜单 的 调用 。 


Kotlin 自 定 义 控 件 


本 章 介绍 了 Android 三 种 常见 的 自 定义 控件 形式 , 包括 自 定义 普通 视图 、 自 定义 简单 动画 、 自 
定义 通知 栏 ， 另 外 介绍 了 安 卓 四 大 组 件 之 一 的 服务 Service 的 常见 用 法 。 最 后 结合 本 章 所 学 的 知识 
演示 一 个 实战 项 目 “ 电 商 App 的 生 鲜 团购 ”的 设计 与 实现 。 


9.1 自 定义 普通 视图 


Android 提供 了 丰富 多 彩 的 视图 与 控件 ， 已 经 能 够 满足 大 部 分 的 业务 需求 ， 然 而 计划 赶不上 变 
化 ， 总 是 有 意料 之 外 的 情况 需要 特殊 处 理 。 比 如 第 7 章 在 “7.3.1 翻 页 视图 ViewPager” 小 节 提 到 
了 翻 页 标题 栏 PagerTabStrip， 该 控件 无 法 在 布局 文件 中 指定 文本 大 小 和 文本 颜色 ， 只 能 在 代码 中 
调用 setTextSize 和 setTextColor 方法 进行 设置 。 这 用 起 来 殊 为 不 便 ， 如 果 它 能 像 TextView 那样 直 
接 在 布局 中 指定 文本 大 小 和 颜色 就 好 了 ， 要 想 让 控件 PagerTabStrip 支持 该 功能 ， 就 得 通过 自 定义 
视图 来 实现 。 本 节 将 对 自 定义 视图 的 三 个 步骤 〈 构 造 对 象 、 测 量 尺 寸 、 绘 制 部 件 ) 进行 详细 介绍 ， 
并 说 明 如 何 使 用 Kotlin 完成 新 视图 的 自 定义 处 理 。 


9.1.1 构造 对 象 


自 定义 视图 的 第 一 种 途径 是 自 定义 属性 ， 仍 旧 以 翻 页 标题 栏 PagerTabStrip 举例 ， 现 在 给 它 新 
增 两 个 自 定义 属性 ， 分 别 是 文本 颜色 textColor 和 文本 大 小 textSize。 接 下 来 给 出 自 定 义 属性 对 应 的 
Java 编码 步骤 。 


ERi 在 resvalues 目录 下 创建 属性 定义 文件 attsxml， 文 件 内 容 如 下 所 示 ， 其 中 
declare-styleable 的 name 属性 值 表示 新 视图 的 名 称 ,两 个 attr 节点 表示 新 增 的 两 个 属性 分 别 是 textColor 
和 textSize: 
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<resources> 
<declare-styleable name="CustomPagerTab"> 
<attr name="textColor" format="color" /> 





<attr name="textSize" format="dimension" /> 
</declare-styleable> 


</resources> 


人 在 模块 源码 的 com.example.custom.widget 包 下 创建 CustomPagerTabjava, 填 入 以 下 自 定 
义 视图 的 Java 代码 : 














Public class CustomPagerTab extends PagerTabStrip { 
Private int textColor = Color.BLACK; 
Private int textSize = 15; 


public CustomPagerTab (Context context) { 
super (context); 


1 


Public CustomPagerTab (Context context, AttributeSet attrs) { 
super (context, attrs); 
// 构 造 函 数 从 attrs .xml 读 取 CustomPagerTab 的 自 定义 属性 
if (attrs != null) { 
TypedArray attrArray=getContext () .obtainStyledRttributes (attrs, 
R.styleable.CustomPagerTab); 
// 从 布局 文件 中 获取 新 属性 textcolor 的 数值 
textColor = 
attrArray.getColor (R.styleable.CustomPagerTab textColor, textColor); 
// 从 布局 文件 中 获取 新 属性 textSize 的 数值 
textSize = 
attrArray.getDimensionPixelSize(R.styleable.CustomPagerTab textSize, textSize); 
attrArray.recycle(); 
} 
// 应 用 布局 文件 的 textColor 文本 颜色 
setTextColor (textColor); 
// 应 用 布局 文件 的 textSize 文本 大 小 
setTextSize (TypedValue.COMPLEX UNIT SP, textSize); 


x //PagerTabStrip 没有 三 个 参数 的 构造 函数 

// Public PagerTab (Context context, AttributeSet attrs, int defStyleAttr) { 
人 } 

3 


CT03 在 布局 文件 的 根 节点 增加 自 定义 的 命名 空间 声明 ， 如 “ xmins:app= 
"http://schemas.android.com/apk/res-auto"”， 并 把 android.support.v4.view.PagerTabStrip 的 节点 名 称 改 为 
自 定义 视图 的 全 路 径 名 称 ， 如 “com.example.custom.widget.PagerTab”， 同 时 在 该 节点 下 指定 新 增 的 两 
个 属性 ， 即 app:textColoe 与 app:textSize。 修 改 之 后 的 布局 文件 示例 如 下 : 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas .android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" 


android:padding="10dp"” > 


<android.support.v4.view.ViewPager 
android:id="@+id/vp content" 





android:layout width="match parent" 
android:layout height="400dp" > 


<com.example.custom.widget .CustomPagerTab 
="@+id/pts_tab" 
android:layout width="wrap content" 





android:i 


android:layout height="wrap content" 
app:textColor="@color/red" 
app:textSize="1l7sp" /> 
</android.support .v4.view.ViewPager> 
</LinearLayout> 


完成 以 上 三 步 修改 后 , 运行 测试 应 用 ,展示 的 界面 效果 如 
图 9-1 所 示 ， 此 时 翻 页 标题 栏 的 文字 颜色 变 为 红色 ， 而 且 字体 
也 变 大 了 。 

上 述 自 定 义 属性 的 操作 一 共有 三 个 步骤 , 其 中 第 二 个 步骤 
涉及 Java 代码 ， 接 下 来 利用 Kotlin 改写 CustomPagerTab 类 的 
代码 ， 主 要 改动 有 以 下 两 点 : 


(1) 原来 的 两 个 构造 函数 合并 为 带 默认 参数 的 一 个 主 构 
造 函数 ， 并 且 主 构造 函数 直接 跟 在 类 名 后 面 定 义 。 

(2) 类 名 后 面 要 补充 注解 “<@JvmOverloads constructor”， 
表示 该 类 支持 被 Java 代码 调用 。 因 为 xml 布局 文件 中 声明 了 
自 定义 视图 的 节点 ， 而 系统 是 通过 SDK 里 的 Java 代码 找到 自 
定义 视图 类 的 ， 所 以 凡是 自 定义 视图 都 要 加 上 该 注解 ， 否 则 
App 运行 时 会 抛 出 异常 。 


下 面 是 CustomPagerTab 类 改写 之 后 的 Kotlin 定义 代码 : 


// 自 定义 视图 要 在 类 名 后 面 增加 “euJvmoverloads constructor”， 因 为 布局 文件 中 的 自 定义 视 
必须 兼容 Java 


class CustomPagerTab @JvmOverloads constructor(context: Context, attrs: 
AttributeSet?=null) : PagerTabStrip(context, attrs) { 
Private var txtColor = Color.BLACK 











vivo X9S 几 











图 9-1 自 定 义 翻 页 标题 栏 的 文字 效果 


Private Var textSize = 15 
nt of 


/ /初始 化 时 从 attrs .xml 读 取 CustomPagerTab 的 自 定义 属性 
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if (attrs != null) { 
val attrArray = getContext () .obtainStyledRAttributes (attrs, 
R.styleable.CustomPagerTab) 
// 从 布局 文件 中 获取 新 属性 textcolor 的 数值 
txtColor = attrArray.getColor (R.styleable. 
CustomPagerTab textColor, txtColor) 
// 从 布局 文件 中 获取 新 属性 textsize 的 数值 
textSize = attrArray.getDimensionPixelSize 
(R.styleable.CustomPagerTab textSize, textSize) 
attrArray.recycle() 
) 
// 应 用 布局 文件 的 textcolor 文本 颜色 
setTextColor (txtColor) 
// 应 用 布局 文件 的 textsize 文本 大 小 
SetTextSize (TypedValue.COMPLEX UNIT SP, textSize.toFloat()) 


9.1.2 测量 尺寸 


从 9.1.1 小 节 看 到 ， 自 定义 视图 的 主 构造 函数 主要 有 两 个 用 途 ， 一 个 是 读 取 布 局 文件 中 的 自 定 
义 属性 值 ， 另 一 个 是 进行 初始 化 设置 。 但 定义 构造 函数 仅仅 是 自 定义 视图 的 一 部 分 ,完整 的 自 定义 
视图 编码 由 以 下 三 部 分 组 成 : 

(1) 定义 构造 函数 ， 读 取 自 定义 属性 值 并 进行 初始 化 设置 。 

(2) 重 写 测 量 函 数 onMesure， 计 算 该 视图 的 宽 高 尺寸 。 

(3) 重 写 绘图 函数 onDraw 或 者 dispatchDraw， 在 当前 视图 内 部 绘制 指定 形状 。 


以 上 自 定 义 视图 编码 的 三 个 组 成 部 分 ， 第 一 部 分 的 构造 函数 已 经 在 9.1.1 小 节 介绍 过 了 ， 接 下 
来 的 两 个 小 节 继 续 介绍 测量 函数 与 绘图 函数 的 重 载 实现 。 

一 个 视图 的 宽 和 高 其 实在 页 面 布局 的 时 候 就 决定 了 ， 视 图 节点 的 android:layout_ width 属性 指 
定 了 该 视图 的 宽度 ， 而 android:layout_height 属性 指定 了 该 视图 的 高 度 。 这 两 个 属性 又 有 三 种 取 值 
方式 , 分 别 是 : 取 值 match_parent 表示 与 上 级 视图 一 样 尺 寸 ， 取 值 wrap_content 表示 按照 自身 内 容 
的 实际 尺寸 ， 最 后 一 种 则 直接 指定 了 有 具体 的 dp 数值 。 在 多 数 情况 下 ， 系 统 按照 这 三 种 取 值 方式 完 
全 能 够 自动 计算 正确 的 视图 宽度 和 视图 高 度 。 

当然 也 有 例外 ， 像 列表 视图 ListView 就 是 个 男 类， 尽管 ListView 在 多 数 场合 的 高 度 计算 也 不 
会 出 错 ， 但 是 把 它 放 到 ScrollView 中 便 出 现 问 题 了 。ScrollView 本 身 叫 作 滚 动 视 图 ， 而 列表 视图 
ListView 也 是 可 以 滚动 的 ,于 是 一 个 滚动 视图 嵌 套 另 一 个 也 能 滚动 的 视图 , 那么 在 双方 的 重 羞 区域 ， 
上 下 滑动 的 手势 究竟 表示 要 滚动 哪个 视图 ? 这 个 滚动 冲突 的 问题 不 只 令 开发 者 脑袋 糊涂 ， 便 是 
Android 系统 也 得 神经 错乱 。 所 以 Android 目前 的 处 理 对 策 是 : 如 果 ListView 的 高 度 被 设置 为 
wrap_content， 此 时 列表 视图 就 只 显示 一 行 的 高 度 ， 然 后 布局 内 部 只 支持 滚动 ScrollView。 

如 此 ， 虽 然 滚动 冲突 的 问题 暂时 解决 ， 但 是 又 带 来 一 个 新 问题 ， 好 好 的 列表 视图 仅仅 显示 一 
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行内 容 , 这 让 出 不 了 头 的 剩余 列表 行情 何以 堪 ? 按照 用 户 正常 的 思维 逻辑 , 列表 视图 应 该 显示 所 有 
行 ， 并 且 列 表 内 容 要 跟着 整个 页 面 一 起 向 上 或 者 向 下 滚动 。 显 然 ， 此 时 系统 对 ListView 的 默认 处 
理 方式 并 不 符合 用 户 习惯 , 只 能 对 其 进行 改造 使 之 满足 用 户 的 使 用 习惯 。 改造 列表 视图 的 一 个 可 行 
方案 是 重 写 它 的 测量 函数 onMesure， 无 论 布 局 文件 中 设 定 的 视图 高 度 是 多 少 ， 都 把 列表 视图 的 高 
度 改 为 最 大 高 度 ， 即 所 有 列表 项 高 度 加 起 来 的 总 高 度 。 

根据 以 上 思路 自 定 义 一 个 扩展 自 ListView 的 不 滚动 列表 视图 NoScrollListView， 它 的 Java 实 
现代 码 如 下 所 示 : 


Public class NoScrollListView extends ListView { 











public NoScrollListView (Context context) { 
super (context); 


; 


public NoScrollListView(Context context, AttributeSet attrs) { 
super (context, attrs); 


) 


Public NoScrollListView(Context context, AttributeSet attrs, int defStyle) { 
super (context, attrs, defStyle); 
h 


@Override 
Public void onMeasure (int widthMeasureSpec, int heightMeasureSpec) { 
// 将 高 度 设 为 最 大 值 ， 即 所 有 项 加 起 来 的 总 高 度 
int expandSpec = MeasureSpec.makeMeasureSpec (Integer.MAX VALUE >> 2, 
MeasureSpec.AT MOST); 
super.onMeasure (widthMeasureSpec, expandSpec); 


} 

看 到 上 面 的 Java 代码 一 口气 写 了 三 个 构造 函数 , 明显 很 喝 味 ,要 是 改写 成 以 下 的 Kotlin 代码 ， 
只 要 一 个 主 构造 函数 就 够 了 : 

// 自 定义 视图 要 在 类 名 后 面 增 加 “eJvmoverloads constructor”， 因 为 布局 文件 中 的 自 定义 视图 
必须 兼容 Java 


class NoScrollListView @JvmOverloads constructor (Context: Context， attrs: 
AttributeSet?=null, defStyle: Int=0) : ListView(context, attrs, defStyle) 1{ 


// 将 高 度 设 为 最 大 值 ， 即 所 有 项 加 起 来 的 总 高 度 
Public override fun onMeasure (widthMeasureSpec: Int, heightMeasureSpec: 
Int) { 





// 注 意 位 运算 符 的 写法 ， 按 位 右 移 在 Kotlin 中 使 用 运算 符 shr 来 表达 

val expandSpec = MeasureSpec.makeMeasureSpec (Integer .MAX VALUE shr 2, 
MeasureSpec.AT MOST) 

super.onMeasure (widthMeasureSpec, expandSpec) 
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接 下 来 , 为 了 方便 演示 改造 前 后 列表 视图 的 界面 效果 对 比 , 在 一 个 页 面 布局 中 放 入 ScrollView 
节点 ， 然 后 在 该 节点 下 面 同时 添加 ListView 节点 和 自 定义 的 NoScrollListView 节点 ， 布 局 文件 的 
内 容 示 例如 下 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<ScrollView 
android:layout width="match parent" 
android:layout height="wrap content" > 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" 
android:orientation="vertical" > 


<TextView 
android:layout width="match parent" 
android:layout height="wrap content" 
android:gravity="center" 
android:padding="50dp" 
android:text=" 下 面 是 系统 自 带 的 ListView" 
android:textColor="@color/red" 
android:textSize="1l7sp" /> 


<ListView 
android:id="@+id/lv_planet" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout marginBottom="50dp" 
android:dividerHeight="ldp" /> 


<TextView 
android:layout width="match parent" 
android:layout height="wrap content" 





android:gravity="center" 
android:padding="50dp" 
android:text=" 下 面 是 全 部 展开 的 ListView" 


android:textColor="@color/green" 
android:textSize="17sp" /> 


<com.example.custom.widget.NoScrollListView 
android:id="@+id/nslv_planet" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout marginBottom="50dp" 
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android:dividerHeight="1dp"” /> 
</LinearLayout> 
</ScrollView> 
</LinearLayout> 


回 到 演示 页 面 的 Activity 代码 , 给 ListView 和 NoScrollListView 两 个 控件 对 象 设置 一 模 一 样 的 
行星 列表 数据 ， 具 体 实现 的 Kotlin 代码 如 下 所 示 : 


class MeasureViewActivity : AppCompatActivity() { 





override fun onCreate (savedInstanceState: Bundle?) { 
Super.onCreate (savedInstanceState) 
setContentView(R.layout .activity measure _ View) 
//1lv_planet 是 系统 自 带 的 ListView， 被 ScrollView 霸 套 只 能 显示 一 行 
val adapterl = PlanetAdapter (this, Planet.defaultList) 
lv planet .adapter = adapterl 
lv planet.onItemClickListener = adapterl 
lv_planet .onIitemLongClickListener = adapterl 
//nslv_planet 是 自 定义 控件 NoScrollListView, 会 显示 所 有 行 
val adapter2 = PlanetAdapter (this, Planet.defaultList) 
nslv planet .adapter = adapter2 
nslv_ planet .onItemClickListener = adapter2 
nslv planet .onItemLongClickListener = adapter2 





重新 编译 运行 App， 然 后 上 下 滑动 测试 页 面 ， 即 可 观察 到 两 种 列表 的 区 别 。 如 图 9-2 所 示 ， 这 
是 测试 页 面 的 初始 界面 ， 此 时 系统 自 带 的 ListView 仅 显 示 一 行内 容 ， 而 开发 者 自 定义 的 
NoScrollListView 显示 多 行内 容 。 接 着 把 测试 页 面 往 上 拉动 ， 滚 动 后 的 界面 如 图 9-3 所 示 ， 此 时 系 
统 自 带 的 ListView 带 着 仅 有 的 一 行 完全 向 上 滚 没 了 ， 而 开发 者 自 定义 的 NoScrollListView 随 着 上 
拉手 势 持续 滚动 ， 可 见 NoScrollListView 内 部 的 列表 项 完 完全 全 地 展示 了 出 来 。 













下 面 是 系统 自 带 的 ListView 


水 星 
he 
行星 ， 也 是 下 大 阳 量 近 的 













水 星 


ee 
行星 ， 忆 是 均 大 局 最 近 的 


金星 
例 旺 大 朋 系 八大 行 星之 一 ,排行 第 二 ,， 拓 
大 J80.725 天 文 单位 


地 球 


地 球星 大 划 系 /大 行星 之 一 ， 扣 行 第 三 ， 亿 是 
太阳 中 站 学 ， 量 和 窑 讼 加 大 的 类 好 行星， 
1.5 亿 公里 

火星 


火 皇 是 大 阳极 大 行星 之 一 ， 拓 行 划 四 ， 居 于 

a 地 生理 ， 百 和 的 为 地球 的 33% 

木星 

Tt 

a 
| 

土星 


二 旺 为 太 阳 系 八大 行星 之 一， 排行 第 六 ， 体 职 
1 于 本 


水 星 


本 时 是 太阳系 八大 行星 生 内 借 也 攻 本 小 的 一 和 
行星 ， 也 导 下 大 阳 星 近 的 行星 


金星 


全 时 是 太阳系 八大 行星 之 一, 排行 第 二 ,下 可 
0725 天 广 间 位 


地 球 








图 9-2 系统 自 带 的 ListView 媒 套 效果 图 9-3 自 定义 的 的 ListView 展开 效果 
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9.1.3 ”绘制 部 件 


自 定义 视图 的 第 三 个 步骤 是 重 写 绘图 函数 , 绘图 函数 包括 onDraw 和 dispatchDraw 两 种 ,二 者 
的 区 别 是 : onDraw 既 出 现在 控件 类 视图 又 出 现在 布局 类 视图 ， 而 dispatchDraw 只 出 现在 布局 类 视 
图 。 假设 一 个 布局 文件 包含 一 个 线性 布局 LinearLayout 节点 ， 且 LinearLayout 节点 下 又 包含 一 个 文 
本 视图 TextView 节点 , 则 它们 之 间 的 绘图 函数 调用 顺序 依次 为 : 线性 布局 的 onDraw 一 文本 视图 的 
onDraw 一 线性 布局 的 dispatchDraw。 这 个 绘图 次 序 意味 着 线性 布局 在 onDraw 函数 中 绘制 的 画面 很 
可 能 被 后 来 的 文本 视图 涂鸦 所 覆盖 ， 但 最 终 定稿 的 却 是 线性 布局 在 dispatchDraw 函数 中 的 绘图 结 
果 。 借 用 " 星 螂 捕 蝉 , 黄 省 在 后 ”的 成 语 类 比 , 此 时 线性 布局 的 onDraw 函数 是 蝉 , 文本 视图 的 onDraw 
函数 是 蛇 螂 ， 线 性 布局 的 dispatchDraw 函数 是 黄 雀 。 

讲 完 了 onDraw 与 dispatchDraw 两 个 函数 之 间 的 次 序 关 系 , 也 就 弄 清楚 了 两 种 绘图 函数 分 别 适 
用 的 场合 ， 即 控件 视图 只 能 重 写 onDraw 函数 ， 而 布局 视图 若 不 想 绘图 效果 被 下 级 控件 覆盖 ， 则 必 
须 重 写 dispatchDraw 函数 。 下 面 举 一 个 自 定义 文本 视图 的 例子 ， 在 当前 文本 视图 的 四 周 绘制 圆 角 
矩形， 对 应 的 Java 实现 代码 如 下 所 示 : 


public class RoundTextView extends TextView { 








Public RoundTextView (Context context) { 
super (context); 


} 


Public RoundTextView(Context context, AttributeSet attrs) { 
super (context, attrs) 7 


Public RoundTextView (Context context, AttributeSet attrs, int defStyle) { 
super (context, attrs, defStyle); 
$ 


// 控 件 只 能 重 写 onDraw 方 法 
@Override 
Protected void onDraw(Canvas canvas) { 
super.onDraw (canvas); 
// 通 过 画笔 Paint 在 画布 canvas 上 绘制 图 案 
Paint paint = new Paint(); 
paint.setColor (Color.RED) ; // 设 置 画笔 的 颜色 
Paint .setStrokenidth (2); // 设 置 线条 的 宽度 
paint.setStyle (Style.STROKE) ; // 设 置 画笔 的 风格 ，STROKE 表示 空心 
paint.setAntiAlias (true); // 设 置 画笔 为 无 锯齿 
RectF rectF = new RectF(1, 1, this.getWidth()-1, this.getHeight()-1); 
// 方 法 drawRoundRect 表示 绘制 圆 角 矩形 


canvas .drawRoundRect (rectF, 10, 10, paint); 
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接着 使 用 Kotlin 改写 自 定 义 的 圆 角 文本 视图 RoundTextView, 则 合并 了 三 个 构造 函数 的 Kotlin 
代码 如 下 所 示 : 


// 自 定义 视图 要 在 类 名 后 面 增加 “@JvmOverloads constructor” 


class RoundTextView @JvmOverloads constructor (Context: Context, attrs: 
AttributeSet?=null, defStyle: Int=0) : TextView(context, attrs, defStyle) { 


// 控 件 只 能 重 写 onDraw 方 法 
override fun onDraw(canvas: Canvas) { 
super.onDraw (canvas) 
// 通 过 画笔 Paint 在 画布 canvas 上 绘制 图 案 
val paint = Paint() 
paint.color = Color.RED // 设 置 画笔 的 颜色 ， 即 红色 
paint.strokeWidth = 2f // 设 置 线条 的 宽度 
paint.style = Style.STROKE // 设 置 画笔 的 风格 ，STROKE 表示 空心 
paint.isAntiAlias = true // 设 置 画 笔 为 无 句 齿 
val rectF = RectF (1f, 1f, (this.width - 1) .toFloat()，(this.height - 1) . 
toFloat () ) 


// 方 法 drawRoundRect 表示 绘制 圆 角 矩形 


canvas .drawRoundRect (rectF, 10f, 10f, paint) 


} 


下 面 再 举 一 个 自 定 义 线性 布局 的 例子 , 同样 在 当前 线性 布局 的 四 周 绘 上 圆 角 和 矩形 , 对 应 的 Java 
实现 代码 如 下 : 


Public class RoundLayout extends LinearLayout { 


Public RoundLayout (Context context) { 
super (context); 


Public RoundLayout (Context context, AttributeSet attrs) { 
super (context, attrs); 
F 


Public RoundLayout (Context context, AttributeSet attrs, int defStyle) { 
super (context, attrs, defStyle); 


// 布 局 一 般 重 写 dispatchDraw 方法 ， 防 止 绘图 效果 被 上 面 的 控件 覆盖 

@Override 

Protected void dispatchDraw(Canvas canvas) { 
super.dispatchDraw (canvas); 
Paint paint = new Paint(); 
Paint.setColor (Color .BLUE); 
paint.setStrokeWidth (2); 
paint.setStyle(Style.STROKE); 
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paint.setAntiAlias (true) 7 
RectF rectF = new RectF(1, 1, this.getWidth()-1, this.getHeight ()-1) 
canvas.drawRoundRect (rectF, 10, 10, paint); 


| 
依然 使 用 Kotlin 改写 自 定义 的 圆 角 布局 RoundLayout， 改 写 后 的 Kotlin 代码 示例 如 下 : 
// 自 定义 视图 要 在 类 名 后 面 增 加 “e@Jvmoverloads constructor” 


class RoundLayout @JvmOverloads constructor (Context: Context, attrs: 
AttributeSet?=null, defStyle: Int=0) : LinearLayout (context, attrs, defStyle) { 


// 布 局 一 般 重 写 dispatchDraw 方法 ， 防 止 绘 图 效果 被 上 面 的 控件 覆盖 
override fun dispatchDraw(canvas: Canvas) { 
super.dispatchDraw (canvas) 
val paint = Paint() 
paint.color = Color.BLUE // 设 置 画笔 的 颜色 ， 即 蓝 色 
paint.strokeWidth = 2f // 设 置 线条 的 宽度 
paint.style = Style.STROKE // 设 置 画笔 的 风格 ，STROKE 表示 空心 
paint.isAntiAlias = true // 设 置 画笔 为 无 锯齿 
val rectF = RectF(1f，1f， (this.width - 1) .toFloat()， (this.height - 
1) .toFloat ()) 
// 方 法 drawRoundRect 表示 绘制 圆 角 矩形 


canvas .drawRoundRect (rectF, 10f, 10f, paint) 


1 


在 接 下 来 的 演示 案例 中 ， 联 合 运 用 新 定义 的 圆 角 文本 视图 RoundTextView 与 圆 角 布局 
RoundLayout， 通 过 外 层 的 RoundLayout 嵌 套 内 层 的 RoundTextView， 以 便 观察 内 外 层 的 两 个 圆 角 
和 矩形。 下 面 是 演示 用 到 的 布局 文件 内 容 : 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" 
android:padding="10dp" > 


<com.example.custom.widget .RoundLayout 
android:layout width="match Parent" 
android:layout height="wrap content" 
android:padding="10dp" 
android:orientation="vertical" > 


<TextView 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:padding="10dp" 
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android:gravity="center" 
android:text=" 入 群 须知 " 
android:textColor="@color/black" 
android:textSize="25sp" /> 


<com.example.custom.widget .RoundTextView 
android:layout width="match Parent" 
android:layout height="wrap_content" 
android:padding="10dp" 
android:text=" 新 入 群 的 朋友 请 注意 ， 入 群 时 先 向 大 家 问好 ， 然 后 自 报 姓名 、 性 别 、 
年 龄 、 身 高 、 体 重 、 职 业 ， 最 重要 的 一 点 是 : 自己 上 传 照片 ! " 
android:textColor="@color/black" 
android:textSize="17sp" /> 
</com.example.custom.widget.RoundLayout> 
</LinearLayout> 


嵌 套 圆 角 和 矩形 的 演示 界面 如 图 9-4 所 示 ， 可 见 所 有 文本 的 外 层 被 一 个 蓝 色 的 圆 角 矩形 所 环绕 ， 
表示 这 是 圆 角 布局 RoundLayout 所 绘制 的 ， 而 新 入 群 注意 事项 的 文本 周围 则 是 一 个 红色 的 圆 角 拢 
形 ， 表 示 这 是 圆 角 文本 视图 RoundTextView 所 绘制 的 。 


入 群 须知 


新 入 群 的 朋友 请 注意 ， 入 群 时 先 向 大 家 

问好 ， 然 后 自 报 姓名 、 性 别 、 年 龄 、 身 红色 
高 、 体 重 、 职 业 ， 最 重要 的 一 点 是 : 自 

己 上 传 照片 ! 














9-4 圆 角 布局 和 圆 角 文本 视图 的 显示 效果 


9.2 自 定义 简单 动画 


手机 App 是 给 人 民 大 众 使 用 的 ， 所 以 不 只 是 要 求 功 能 方面 能 够 正常 运行 ， 也 要 求 界面 上 的 用 
户 体验 足够 美观 活泼 。 想 想 看 ， 一 个 静止 不 动 的 应 用 界面 明显 缺乏 变化 ， 流 于 僵硬 ; 相 比 之 下 , 一 
个 动态 展示 的 应 用 界面 既 让 人 觉得 流畅 又 让 人 觉得 舒服 。 动态 展示 往往 用 到 动画 技术 , 对 于 简单 的 
动画 效果 来 说 ， 只 需要 短 时 间 的 间隔 ,然后 持续 刷新 界面 即 可 。 这 里 的 持续 刷新 动作 便 是 本 节 将 要 
讲述 的 任务 Runnable， 除 此 之 外 ， 本 节 还 将 介绍 如 何 利用 任务 Runnable 结合 进度 条 ProgressBar 实 
现 一 个 简单 的 进度 条 动画 。 


9.2.1 任务 Runnable 


任务 Runnable 定义 了 一 个 可 以 独立 运行 的 代码 片段 ， 通 常用 于 界面 控件 的 延迟 处 理 ， 比 如 有 
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时 为 了 避免 同时 占用 某 种 资源 造成 冲突 , 有 时 则 是 为 了 反复 间隔 刷新 界面 从 而 产生 动画 效果 。 运行 
一 个 任务 也 有 多 种 形式 ， 既 能 在 UI 线程 中 调用 处 理 器 对 象 的 post 或 者 postDelayed 方法 ， 也 能 另 
外 开启 分 线程 来 执行 Runnable 对 象 。 在 运行 任务 之 前 ， 必 须 事先 声明 该 任务 的 对 象 ， 然 后 才能 由 
调用 者 执行 该 任务 。Kotlin 代码 声明 Runnable 对 象 有 4 种 方式 ， 分 别 对 应 不 同 的 业务 场景 ， 接 下 
来 就 依次 阐述 Runnable 对 象 在 Kotlin 编码 中 的 4 种 声明 方式 : 内 部 类 、 匿 名 内 部 类 、 简 化 类 实例 、 
匿名 实例 。 

1. 内 部 类 

内 部 类 方式 是 最 循规蹈矩 的 , 在 代码 里 先 书写 一 个 继承 自 Runnable 的 内 部 类 , 再 重 写 它 的 run 
方法 ， 填 入 有 具体 的 业务 逻辑 处 理 。 以 最 常见 的 计数 器 为 例 ,每 隔 一 秒 便 在 界面 上 显示 加 一 后 的 计数 
结果 ， 使 用 内 部 类 方式 进行 演示 的 话 ， 就 是 以 下 的 Kotlin 代码 例子 : 


Private val handler = Handler() 








Private Var count = 0 
//inner 修饰 符 表示 这 是 一 个 内 部 类 
inner Private class Counter : Runnable { 
Override fun run() { 
Count++ 
tv_result.text = "当前 计数 值 为 : $count" 
handler.postDelayed (this, 1000) 


» 
然后 在 Activity 页 面 的 按钮 点 击 事件 中 加 入 下 面 一 行 Kotlin 代码 , 在 点 击 按钮 时 触发 这 个 计数 
任务 : 
handler.post (Counter ()) 


运行 测试 应 用 ， 界 面 上 的 计数 效果 如 图 9-5 和 图 9-6 所 示 ， 其 中 图 9-5 表示 当前 正在 计数 ， 图 
9-6 表示 当前 停止 计数 ， 终 止 的 计数 值 为 12。 











停止 计数 开始 计数 
当前 计数 值 为 : 4 当前 计数 值 为 : 12 
图 9-5 计数 任务 开始 计数 图 9-6 计数 任务 停止 计数 
2. 匿名 内 部 类 





内 部 类 的 方式 最 正规 ， 无 疑 也 是 最 喝 唆 的 。 由 于 这 个 计数 任务 仅仅 在 点 击 按钮 时 启动 一 次 ， 
因此 并 不 需要 对 其 显 式 构造 , 只 要 在 定义 内 部 类 时 顺便 声明 该 任务 的 实例 即 可 。 此 时 的 任务 定义 代 
码 便 从 内 部 类 方式 变 成 了 匿名 内 部 类 方式 , 采取 Kotlin 编码 的 话 ， 注意 使 用 关键 字 object 占 位 ， 表 
示 这 是 一 个 匿名 内 部 类 ， 完 整 的 Kotlin 任务 定义 代码 如 下 所 示 : 
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// 使 用 关键 字 object 占 位 ， 表 示 这 是 一 个 匿名 内 部 类 
Private val counter = object : Runnable { 
override fun run() { 
Count++ 
tv_result.text = "当前 计数 值 为 : $count" 
handler.postDelayed (this, 1000) 


有 

因为 定义 内 部 类 的 同时 就 声明 了 任务 实例 ， 所 以 处 理 器 直接 运行 该 实例 即 可 启动 计数 ”任务 : 

handler .post (counter) 

内 部 类 与 匿名 内 部 类 这 两 种 方式 其 实 内 部 都 拥有 类 的 完整 形态 ,故而 它们 的 run 方法 允许 使 用 
关键 字 this 指 代 自 身 的 任务 对 象 ， 于 是 示例 代码 中 的 “handler.postDelayed(this, 1000)” 表 示 间 隔 一 
秒 之 后 重复 执行 自身 任务 。 正 因为 能 够 重复 执行 任务 , 所 以 这 两 种 方式 可 用 于 持续 刷新 界面 的 动画 
效果 。 


3. 简化 类 实例 
前 面 两 种 内 部 类 实现 方式 拥有 类 的 完整 形态 , 意味 着 必须 显 式 重 写 run 方法 , 可 是 这 个 任务 类 
肯定 只 能 重 写 run 方法 ， 即 使 开发 者 不 写 出 来 ，run 方法 也 是 逃 不 掉 的 。 在 第 1 章 ， 当 时 为 了 演示 
Kotlin 代码 的 简洁 性 ， 举 了 一 个 例子 “按钮 对 象 .setOnClickListener { 点 击 事件 的 处 理 代码 }”， 
这 种 写法 正 是 采取 了 Lamba 表达 式 , 直接 把 点 击 事件 接口 的 唯一 方法 onClick 给 省 略 掉 。 因 此 ， 本 
节 的 任务 实例 也 可 以 使 用 类 似 的 写法 ， 只 要 说 明 该 实例 是 Runnable 类 型 ， 多 余 的 run 方法 就 能 如 
下 面 是 将 任务 实例 按照 简化 形式 改写 后 的 Kotlin 代码 : 
// 把 类 的 继承 与 方法 重 载 步 骤 给 简化 掉 了 
Private val counter = Runnable { 
count++ 
tv_result.text = "当前 计数 值 为 : $count" 
1 


显而易见 ， 上 述 的 counter 仍 是 Runnable 类 型 ， 于 是 处 理 器 依旧 运行 该 实例 即 可 启动 任务 : 

handler.post (counter) 

不 过 这 种 去 掉 run 方法 的 写法 是 有 代价 的 , 虽然 表面 上 代码 变 得 简洁 , 但 是 并 不 拥有 类 的 完整 
结构 ， 其 内 部 的 this 关键 字 不 再 表示 任务 类 自身 ， 而 是 表示 宿主 类 〈 即 Activity 活动 类 ) 。 鉴 于 这 
点 变化 ， 该 方式 内 部 不 可 再 调用 处 理 器 的 post 或 者 postDelayed 方法 ， 意 味 着 此 时 任务 实例 无 法 重 
复 调用 自身 。 因 此 ， 采取 简 化 类 实例 的 任务 对 象 适用 于 不 需要 重复 刷新 的 场合 。 


4. 匿名 实例 
注意 到 前 面 第 三 种 方式 的 counter 是 一 个 经 过 等 号 赋值 的 任务 实例 ， 既 然 这 样 ， 不 如 直接 把 等 
号 右边 的 表达 式 加 入 post 方法 中 ， 就 像 下 面 的 Kotlin 代码 那样 : 
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// 第 1 种 写法 : 在 post 方法 中 直接 填写 Runnable 对 象 的 定义 代码 
handler.post (Runnable { 
Count++ 
tv_result .text = "当前 计数 值 为 : $count" 
1 
上 面 的 代码 还 可 以 进一步 精简 ， 因 为 post 方法 只 能 输入 Runnable 类 型 的 参数 ， 所 以 括号 内 部 的 
Runnable 纯 属 多 余 ; 另外 ，post 方法 有 且 仅 有 一 个 输入 参数 ， 于 是 圆 括号 嵌 套 大 括号 稍 显 烦琐 。 把 
这 两 个 见 余 之 处 分 别 予 以 删除 与 合并 ， 于 是 得 到 了 下 面 匿名 实例 版 的 Kotlin 代码 : 
// 第 2 种 写法 : 如 果 该 任务 只 需 执行 一 次 ， 就 可 以 采用 匿名 实例 的 方式 直接 嵌入 任务 的 执行 代码 
handler.post { 
count++ 
tv_result .text = "当前 计数 值 为 : $count" 
} 
上 述 去 掉 圆 括 号 的 办 法 只 适合 post 方法 这 种 仅 有 一 个 参数 的 调用 ， 如 果 其 他 方法 存在 多 个 输 
入 参数 (如 postDelayed 方法 ) ， 那 么 外 层 的 圆 括号 仍 需 予以 保留 ， 此 时 大 括号 及 其 内 部 代码 就 作 
为 一 个 函数 参数 传 入 。 恢 复 圆 括号 的 Kotlin 调用 代码 如 下 所 示 : 
// 第 3 种 写法 : 如 果 是 延迟 执行 任务 ， 就 可 将 匿名 实例 作为 postDelayed 的 输入 参数 
handler.postDelayed({ 
count++ 
tv_result.text = "当前 计数 值 为 : $count" 
}, 1000) 


匿名 实例 方式 直接 把 任务 代码 写 在 调用 函数 之 中 ， 意 味 着 这 段 任务 代码 无 法 被 其 他 地 方 调用 ， 
所 以 它 的 适用 场景 更 加 狭小 。 简 化 类 实例 虽然 无 法 重复 调用 自身 , 但 是 尚且 允许 在 不 同 地 方 多 次 调 
用 , 而 匿名 实例 只 能 在 它 待 过 的 地 方 县 花 一 现 , 因此 还 是 要 根据 实际 的 业务 要 求 来 选择 合适 的 任务 
方式 。 


9.2.2 ”进度 条 ProgressBar 


本 节 的 简单 动画 准备 拿 进度 条 动画 练 练 手 ， 因 此 接 下 来 先 了 解 一 下 Android 的 进度 条 控件 
ProgressBar。 进 度 条 有 两 种 ， 分 别 是 水 平 进度 条 和 圆圈 进度 条 。 水 平 进度 条 为 水 平方 向 上 的 一 根 灰 
色 线 条 ， 人 允许 指定 最 大 进度 和 当前 进度 。 要 想 在 布局 文件 中 声明 水 平 进度 条 ， 可 添加 style 属性 值 
为 progressBarStyleHorizontal 的 进度 条 ProgressBar 节点 ， 举 例如 下 : 

<ProgressBar 
android:id="@+id/pb_progress" 
style="?android:attr/progressBarSstyleHorizontal" 
android:layout width="match parent" 
android:layout height="30dp" /> 
到 圈 进 度 条 则 为 一 个 在 不 停 转 动 的 灰色 圆圈 ， 无 法 指定 最 大 进度 和 当前 进度 。 要 想 在 布局 文件 
中 声明 圆圈 进度 条 ， 可 添加 style 属性 值 为 progressBarStyle 的 进度 条 ProgressBar 节点 ， 举 例如 下 : 

















条 
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<ProgressBar 
android:id="@+id/pb progress" 
style="?android:attr/progressBarStyle" 
android:layout width="match parent" 
android:layout height="30dp" /> 


因为 圆圈 进度 条 无 法 设置 最 大 进度 和 当前 进度 ， 造 成 它 的 实用 性 不 强 ， 所 以 本 小 节 主 要 介绍 
水 平 进度 条 。 水 平 进度 条 的 常用 方法 /属性 在 Kotlin 与 Java 中 的 调用 方式 见 表 9-1。 
表 9-1 水 平 进度 条 的 方法 /属性 在 Kotlin 与 Java 中 的 调用 方式 对 比 









































水 平 进度 条 的 方法 /属性 说 明 Kotlin 的 属性 名 称 Java 的 方法 名 称 
设置 当前 进度 progress setProgress 

设置 进度 条 的 最 大 值 max SetMax 
设置 进度 条 的 进度 图 形 progressDrawable setProgressDrawable 





由 于 系统 自 带 的 水 平 进度 条 只 是 一 根 灰色 粗 线条 ， 缺 少 变化 ， 也 不 美观 ， 因 此 实际 开发 中 党 
常 需 要 自 定义 进度 条 的 样式 图 案 。 此 时 就 得 通过 进度 条 控件 的 progressDrawable 属性 来 设置 该 进度 
条 的 进度 图 形 ， 注 意 这 个 进度 图 形 不 能 用 普通 图 形 ， 只 能 用 层次 图 形 LayerDrawable。 层 次 图 形 可 
在 xml 文件 中 定义 ， 倘 车 用 于 描述 进度 图 形 ， 则 要 同时 定义 两 个 层次 ， 即 背景 层次 与 进度 条 层次 。 

下 面 是 一 个 层次 图 形 定义 的 xml 例子 ， 其 中 根 节点 layer-list 表示 这 是 一 个 层次 列表 ， 即 层次 
图 形 定义 。 其 下 面 再 定义 两 个 层次 ， 其 中 背景 层次 的 id 为 @android:id/background， 采 用 的 是 形状 
图 形 (节点 名 称 为 shape); 进度 条 层次 的 id 为 @android:id/progress, 采用 的 是 裁 前 图形 ClipDrawable 

(节点 名 称 为 clip) : 
<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
<item android:id="@android:id/background"> 
<shape> 
<solid android:color="#333333" /> 
</shape> 
</item> 
<item android:id="@android:id/progress"> 
<clip> 
<nine-patch android:src="@drawable/notify green" /> 
</clip> 
</item> 

</layer-list> 

在 Activity 中 使 用 进度 条 控件 的 Kotlin 代码 如 下 所 示 , 主要 是 根据 输入 的 进度 数值 展示 进度 条 
的 当前 进度 : 

class ProgressBarActivity : AppCompatActivity() { 

override fun onCreate (savedInstanceState: Bundle?) { 


super.onCreate (savedInstanceState) 
setContentView(R.layout .activity progress bar) 


第 9 章 Kotlin 自 定义 控件 | 257 


// 设 置 最 大 进度 

Pb _progress.max = 100 

// 设 置 默认 进度 

Pb progress.progress = 0 
// 设 置 进度 条 图 形 


Pb progress.progressDrawable = resources.getDrawable 
(R.drawable.progress green) 
btn progress.setOnClickListener { 
// 根 据 输入 的 进度 数值 展示 进度 条 的 当前 进度 


Pb progress.progress = et progress.text.toString() .toInt() 


} 

进度 条 的 进度 数值 变更 前 后 的 界面 效果 如 图 9-7 与 图 9-8 所 示 ， 其 中 图 9-7 所 示 为 进度 值 为 0 
的 界面 ， 此 时 只 有 一 根 黑色 的 进度 条 背景 图 9-8 所 示 为 进度 值 为 60 的 界面 ， 此 时 绿色 进度 条 占 
据 全 部 进度 的 60% 长 度 。 


custom custom 

















9-7 ”当前 进度 为 0 的 进度 条 界面 图 9-8 ”当前 进度 为 60 的 进度 条 界面 


9.2.3 ” 自 定义 文本 进度 条 


不 过 ， 就 算 进 度 条 用 上 了 自 定 义 的 进度 图 形 ， 仍 然 存在 不 足 之 处 。 比 如 进度 条 仅仅 显示 一 段 
进度 图 形 , 并 未 显示 进度 数值 的 文本 , 用 户 如 何 才能 得 知 当前 的 具体 进度 ? 故而 可 在 进度 条 中 间 增 
加 文字 提示 ， 使 之 符合 用 户 的 视觉 需求 。 但 是 ProgressBar 没有 提供 设置 文本 的 方法 ， 于 是 要 想 在 
进度 条 中 央 显 示 进 度 文字 ， 就 得 基于 ProgressBar 自 定义 一 个 进度 条 。 自 定义 进度 条 的 思路 主要 是 
;onDraw 绘图 函数 ， 在 该 函数 中 调用 canvas 的 drawText 方法 ， 往 进度 条 的 中 央 位 置 添加 进度 
文本 。 

下 面 是 上 述 文本 进度 条 的 Kotlin 自 定义 代码 例子 : 

// 自 定义 视图 要 在 类 名 后 面 增加 “@JvmOverloads constructor”， 因 为 布局 文件 中 的 自 定义 视图 
必须 兼容 Java 


class TextProgressBar @JvmOverloads constructor (Context: Context, attrs: 
AttributeSet? = null, defStyle: Int = 0) : ProgressBar(context, attrs, defStyle) { 








Var progressText = 
Private var paint: Paint 
Private var textColor = Color.WHITE 
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Private Var textSize = 30f 
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// 初 始 化 画笔 

Paint = Paint() 
Paint.color = textColor 
Paint.textSize = textSize 


override fun onDraw(canvas: Canvas) { 


super .onDraw (canvas) 

val rect = Rect() 

// 获 得 进度 文本 的 矩形 边界 

Paint.getTextBounds (progressText, 0, progressText.length, rect) 
val x = width / 2 - rect.centerX() 

val y = height / 2 - rect.centerY() 

// 把 文本 内 容 绘制 在 进度 条 的 中 间 位 置 


canvas .drawText (progressText, x.toFloat(), y.toFloat(), paint) 


自 定义 文本 进度 条 的 显示 效果 如 图 9-9 与 图 9-10 所 示 ， 其 中 图 9-9 展示 当前 进度 为 40% 时 的 


界面 ， 图 9-10 展示 当前 进度 为 80% 时 的 界面 。 


图 9-9 当前 进度 为 40% 的 文本 进度 条 


custom custom 





图 9-10 当前 进度 为 80% 的 文本 进度 条 


9.2.4 “实现 进度 条 动画 


现在 有 了 任务 Runnable 和 自 定义 的 文本 进度 条 TextProgressBar 做 铺垫 ,就 能 很 方便 地 实现 进 


度 条 滚动 刷新 的 动画 效果 了 。 先 把 “9.2.1 任务 Runnable ”小 节 提 到 的 计数 器 Runnable 代码 拿 过 来 ， 
然后 补充 对 进度 值 的 判断 处 理 : 在 当前 进度 未 达到 100% 时 , 更 新 文本 进度 条 的 进度 值 与 进度 文本 ; 
一 旦 当前 进度 超过 100%， 就 停止 进度 更 新 ， 并 展示 100% 进 度 时 的 控件 界面 。 


据 此 编写 进度 条 动画 的 Kotlin 页 面 代码 如 下 所 示 : 


class ProgressAnimationActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 


super.onCreate (savedInstanceState) 
setContentView(R.layout .activity progress animation) 
btn animation.setOnClickListener { 
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btn animation.isEnabled = false 
// 延 迟 50 毫秒 开始 进度 条 动画 
handler.postDelayed (animation, 50) 


; 


Private var mProgress = 0 
Private val handler = Handler() 
// 定 义 一 个 刷新 进度 条 的 任务 
Private val animation = object : Runnable { 
override fun run() { 
if (mProgress <= 100) { 
tpb progress.progress = mProgress 
tpb progress.progressText = "当前 处 理 进 度 为 $mProgress%" 
// 当 前 进度 未 满 100%$， 继 续 进度 刷新 动画 
handler.postDelayed (this, 50) 
mpProgress++ 
} else { 
// 进 度 条 动画 结束 ， 恢 复 初始 进度 数值 
mProgress = 0 
btn animation.isEnabled = true 


} 
接 下 来 观看 一 下 进度 条 动画 的 演示 结果 ， 如 图 9-11 所 示 ， 此 时 进度 条 动画 播放 到 了 51%; 如 
图 9-12 所 示 ， 此 时 进度 条 动画 播放 完毕 ， 当 前 进度 停留 在 100% 的 位 置 。 


当前 处 理 进度 为 100% 





播放 进度 条 动画 播放 进度 条 动画 








图 9-11 进度 条 动画 正在 播放 图 9-12 进度 条 动画 结束 播放 


9.3 自 定义 通知 栏 


通知 栏 Notification 是 Android 倾 力 打造 的 一 个 重要 部 件 ， 几 乎 每 个 大 版 本 都 对 通知 栏 进行 了 
卓有成效 的 升级 , 那么 最 新 的 通知 栏 究竟 具备 哪些 激动 人 心 的 功能 ?” Kotlin 又 是 怎样 编码 实现 推送 
通知 的 ? 带 着 这 些 疑 问 , 本 节 将 一 步 一 步 抽 丝 剥 草 , 把 通知 栏 的 各 个 重要 特性 及 其 用 法 逐步 地 展现 
在 读者 面前 。 
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9.3.1 通知 推送 Notification 


在 手机 屏幕 的 顶端 下 拉 会 弹出 一 列 通知 栏 ， 里 面 放 的 是 各 个 App 想 即 时 提醒 用 户 的 消息 ， 这 
个 消息 内 容 是 由 系统 的 通知 服务 产生 并 推送 的 。 每 条 消息 通知 基本 都 有 这 些 元 素 : 图 标 、 标 题 、 内 
容 、 时 间 等 ， 它 的 消息 参数 通过 Notification.Builder 构建 ， 下 面 介 绍 常用 的 消息 参数 构建 方法 。 


setAutoCancel: 设置 该 通知 是 否 自动 清除 。 若 为 true， 则 点 击 该 通知 后 ， 通 知 会 自动 消失 ; 
若 为 false， 则 点 击 该 通知 后 ， 通 知 不 会 消失 。 


@ setWhen: 设置 推送 时 间 ， 格 式 为 “小 时 : 分 钟 "。 推送 时 间 在 通知 栏 右 方 显示 。 
@ setShowWhen: 设置 是 否 显示 推送 时 间 。 


setUsesChronometer: 设置 是 否 显示 计数 器 。 为 true 时 将 不 显示 推送 时 间 ， 动态 显 示 从 通知 被 
推送 到 当前 的 时 间 间 隔 ， 以 “分 钟 : 秒 钟 ” 格 式 显示 。 

setSmallIcon: 设置 状态 栏 里 面 的 图 标 (小 图 标 )。 

setTicker: 设置 状态 栏 里 面 的 提示 文本 。 

setLargelcon : 设置 通知 栏 里 面 的 图 标 ( 大 图 标 )。 

setContentTitle: 设置 通知 栏 里 面 的 标题 文本 。 

setContentText: 设置 通知 栏 里 面 的 内 容 文本 。 

setSubText: 设置 通知 栏 里 面 的 附加 说 明文 本 ， 位 于 内 容 文 本 下 方 。 若 调用 该 方法 ， 则 
setProgress 的 设置 将 失效 。 

setProgress: 设置 进度 条 与 当前 进度 。 进 度 条 位 于 标题 文本 与 内 容 文本 中 间 。 

setNumber: 设置 通知 栏 右 下 方 的 数字 ， 可 与 setProgress 联合 使 用 ， 表 示 当 前 的 进度 数值 。 
setContentInfo: 设置 通知 栏 右 下 方 的 文本 。 若 调用 该 方法 ， 则 setNumber 的 设置 将 失效 。 
setContentIntent: 设置 内 容 的 延迟 意图 PendingIntent， 在 点 击 该 通知 时 触发 该 意图 。 通 常 调用 
PendingIntent 的 getActivity 方法 获得 延迟 意图 对 象 ，getActivity 表示 点 击 后 跳 转 到 该 页 面 。 
setDeleteIntent: 设置 删除 的 延迟 意图 PendingIntent， 在 滑 掉 该 通知 时 触发 该 动作 。 


@ ”build: 构建 方法 。 在 以 上 参数 都 设置 完毕 后 ， 调 用 该 方法 会 返回 Notification 对 象 。 


接 下 来 演示 两 个 不 同样 式 的 通知 消息 : 静止 的 简单 消息 和 动态 的 计时 消息 。 
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. 静止 的 简单 消息 


大 多 数 消息 通知 都 是 这 种 静态 的 文本 消息 ， 通 常 简 简单 单一 句 话 告诉 用 户 有 什么 新 鲜 事 了 、 
推出 什么 新 活动 了 等 。 然后 待 用 户 点 击 该 通知 后 , 就 跳 到 设 定好 的 活动 页 面 。 构建 简单 消息 的 时 候 ， 
需要 注意 下 面 两 点 : 


(1) setSmallIcon 方法 必须 调用 ， 和 否则 不 会 显示 通知 消息 。 
(2) setSubText 与 setProgress 两 个 方法 同时 只 能 调用 其 一 ， 因 为 附加 说 明 与 进度 条 都 位 于 标 


题 文 本 的 下 方 。 
下 面 是 发 送 简单 消息 的 Kotlin 代码 片段 : 
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Private fun sendSimpleNotify(title: String, message: String) { 
// 声 明 一 个 点 击 通知 消息 时 触发 的 动作 意图 
val clickIntent = intentFor<MainActivity>() 
val piClick = PendingIntent.getRctivity(this， 
R.string.apP_name，clickIntent， 
PendingIntent .FLAG UPDATE CURRENT) 
// 开 始 构建 简单 消息 的 各 个 参数 
val builder = Notification.Builder (this) 
val notify = builder.setContentIntent (PiClick) 
.SetAutoCancel (true) 
.SetSmallIcon (R.drawable.ic app) 
.SetSubText ("这 里 是 副本 ") 
.setTicker ("简单 消息 来 啦 ") 
.SetWhen (System.currentTimeMillis()) 
.SetLargeIcon (BitmapFactory.decodeResource (resources, 
R.drawable.ic app)) 
.SetContentTitle (title) 
.SetContentText (message) .build() 
// 获 取 系统 的 通知 管理 器 
val notifyMgr = getSystemService(Context .NOTIFICATION SERVICE) as 
NotificationManager 
notifyMgr.notify(R.string.app_name, notify) 
} 


简单 消息 的 通知 栏 效果 如 图 9-13 所 示 ， 可 见 通知 栏 左边 是 图 标 ， 中 间 是 标题 与 内 容 ， 右 边 是 
推送 时 间 。 


好 消息 


因 超 市 倒闭 ， 现 清仓 处 理 





图 9-13 简单 消息 的 通知 栏 效果 


2. 动态 的 计时 消息 
在 消息 通知 的 右边 放置 一 个 计时 器 Chronometer， 这 便 形 成 了 能 够 动态 显示 已 逝去 时 间 的 计时 


(1) setWhen 与 setUsesChronometer 两 个 方法 同时 只 能 调用 其 一 ， 也 就 是 说 推送 时 间 与 计数 
器 无 法 同时 显示 ， 因 为 它们 都 位 于 通知 栏 的 右边 。 
(2) setNumber 与 setContentInfo 两 个 方法 同时 只 能 调用 其 一 ， 因 为 计数 值 与 提示 都 位 于 通知 
栏 的 右 下 方 。 
下 面 是 发 送 计 时 消息 的 Kotlin 代码 片段 : 
Private fun sendCounterNotify (title: String, message: String) { 


// 声 明 一 个 删除 通知 消息 时 触发 的 动作 意图 


val cancelIntent = intentFor<MainActivity>() 
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val piDelete = PendingIntent .getActivity(this, 
R.string.app_name, cancelIntent, 
PendingIntent .FLAG UPDATE CURRENT) 
// 开 始 构 建 计时 消息 的 各 个 参数 
val builder = Notification.Builder (this) 
val notify = builder.setDeleteIntent (piDelete) 
.SetAutoCancel (true) 
.SetUsesChronometer (true) 
.SetProgress(100, 60, false) 
.setNumber (99) 
.SetSmallIcon (R.drawable.ic app) 
.setTicker ("计数 消息 来 啦 ") 
.SetLargeIcon (BitmapFactory.decodeResource (resources, 
R.drawable.ic app)) 
.SetContentTitle (title) 
.SetContentText (message) .build() 
// 获 取 系 统 的 通知 管理 器 
val notifyMgr = getSystemService (Context.NOTIFICRTION_SERVICE) as 
NotificationManager 
notifyMgr.notify(R.string.app name, notify) 
3} 


计时 消息 的 通知 栏 效果 如 图 9-14 所 示 ， 可 见 通 知 栏 左边 是 图 标 ， 中 间 是 标题 文本 、 进 度 条 、 
内 容 文 本 ， 右 边 是 计时 器 与 计数 值 。 


蜗牛 和 黄酮 鸟 


阿 黄 阿 酮 鸟 不 要 笑 ， 等 我 尾 上 它 就 成 熟 了 





图 9-14 计时 消息 的 通知 栏 效果 


9.3.2 ”大 视图 通知 


9.3.1 小 节 介绍 了 消息 通知 的 基本 样式 ， 从 效果 图 看 到 每 条 通知 都 只 有 罕 罕 的 一 行 消息 ， 而 且 
交互 方式 也 比较 简陋 ， 未 免 显 得 小 家 子 气 。 于 是 Android 从 API 16 开始 (Android 4.1) 引入 了 新 
的 大 视图 通知 ， 所 谓 大 视图 通知 ， 就 是 块头 大 〈 即 高 度 增加 )》 了 。 除 了 高 度 增 加 外 ， 大 视图 通知 也 
新 增 了 几 项 好 用 的 功能 ， 比 如 允许 设置 通知 到 达 的 提醒 方式 、 允 许 设置 多 个 按钮 分 别 指定 响应 方式 
等 ， 如 此 一 来 ， 不 但 块头 变 大 ， 功 能 也 增强 了 ， 名 副 其 实地 做 到 了 大 气 磅 磷 。 

大 视图 通知 的 参数 出 人 意料 地 没有 继续 使 用 Notification.Builder 构建 ， 而 是 采用 新 来 的 
NotificationCompat.Builder。 当然 , 新 来 的 伙计 除了 掌握 Notification.Builder 已 有 的 参数 设置 方法 外 ， 
另外 还 添加 了 几 个 大 视图 额外 功能 的 对 应 方法 ， 这 几 个 新 方法 的 功能 具体 说 明 如 下 。 

”setDefaults: 设置 通知 到 达 的 提醒 方式 . 可 同时 设置 多 种 通知 方式 , 每 种 通知 方式 之 间 使 用 位 

运算 符 “or” 连 接 。 提 醒 方式 的 取 值 说 明 见 表 9-2。 
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表 9-2 ”通知 到 达 的 提醒 方式 取 值 说 明 


通知 到 达 的 提醒 方式 


说 明 





Notification.DEFAULT ALL 


默认 所 有 





Notification. DEFAULT_SOUND 


默认 铃声 





Notification. DEFAULT_VIBRATE 


默认 震动 





Notification. DEFAULT_LIGHTS 





默认 闪光 


@ addAction: 在 本 通知 底部 添加 一 个 动作 按钮 , 可 同时 添加 多 个 按钮 这 些 按钮 从 左 到 右 排列 。 
该 方法 的 第 一 个 参数 为 按钮 图 片 的 资源 ID， 第 二 个 参数 为 按钮 的 文本 内 容 ， 第 三 个 参数 为 点 
击 按钮 对 应 的 动作 意图 。 

@ setStyle: 设置 该 通知 的 大 视图 风格 。 大 视图 通知 有 三 种 风格 类 型 ， 分 别 是 大 文本 风格 
NotificationCompat.BigTextStyle、 大 图 片 风格 NotificationCompat.BigPictureStyle 和 收 件 箱 风格 
NotificationCompat.InboxStyle。 具 体 的 风格 类 型 取 值 说 明 见 表 9-3。 


表 9-3 大 视图 通知 的 三 种 风格 类 型 说 明 

















大 视图 说 明 大 视图 风格 内 容 设置 方法 。 “| 方法 的 说 明 
大 文本 风格 BigTextStyle bigText 设置 大 视图 中 间 的 文本 内 容 
大 图 片 风 格 BigPictureStyle “| bigPicture 设置 大 视图 中 间 的 图 片 内 容 
添加 一 行 消息 文本 。 可 多 次 调用 该 方法 ， 每 调用 一 
收 件 箱 风格 InboxStyle addLine 次 就 添加 一 行 消息 


除了 表 9-3 列 出 的 特有 方法 外 ， 


= 种 大 视图 风格 还 共同 支持 下 面 的 两 种 风格 设置 方法 。 


esetBigContentTitle: 设置 大 视图 通知 的 标题 文本 。 
@ setSummaryText: 设置 大 视图 通知 的 摘要 文本 。 摘 要 文本 位 于 底部 按钮 的 上 方 。 


需要 注意 的 是 ， 大 视图 通知 并 


F 不 总 是 完全 展开 显示 ， 大 多 数 情况 仍然 像 一 般 通 知 那样 只 显示 


狭窄 的 一 行 , 只 有 在 该 通知 处 于 通知 栏 项 部 并 且 用 户 将 其 下 拉 时 ,大 视图 通知 才 会 向 下 展示 完整 的 


大 篇 幅 消 息 。 


下 面 是 构建 并 发 送 大 视图 通 甸 


Private fun getStyleandSend (title: String, message: String, type: Int) { 
Var style: NotificationCompat.Style? = null 





when (type) { 





0 -> { // 声 明 大 文本 风格 
style = NotificationCompat.BigTextStyle() 
style.setBigContentTitle (title) 
style.setSummaryText (message) 


style.bigText ("这 是 一 条 大 文字 风格 的 通知 消息 ") 


} 


1 -> { // 声 明 大 图 片 风格 
style = NotificationCompat.BigPictureStyle () 


的 Kotlin 代码 片段 : 
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style.setBigContentTitle (title) 
style.setSummaryText (message) 
style.bigLargeIcon (BitmapFactory.decodeResource (resources, 
R.drawable.icon financer)) 
style.bigPicture (BitmapFactory.decodeResource (resources, 
R.drawable.icon sunshine)) 
} 
2 -> { // 声 明 收 件 箱 风格 
style = NotificationCompat.InboxStyle() 
style.setBigContentTitle (title) 
style.setSummaryText (message) 
style.addLine ("天 青色 等 烟雨 ， 而 我 在 等 你 ") 
style.addLine (" 炊 烟 盘 振 升 起 ， 隔 江 千 万 里 ") 
style.addLine ("在 瓶 底 书 汉 素 仿 前 朝 的 飘逸 ") 


} 
sendLargeNotify(title, message, style) 
toast ("大 视图 消息 已 推送 到 通知 栏 。") 


Private fun sendLargeNotify(title: String, message: String, style: 
NotificationCompat.Style?) { 
// 声 明 一 个 “取消 ”按钮 的 动作 意图 
val cancelIntent = intentFor<NotifyLargeActivity>() 
val piCancel = PendingIntent.getRActivity(this， 
R.string.app name, cancelIntent, 
PendingIntent .FLAG UPDATE CURRENT) 
// 声 明 一 个 “前 往 ” 按 钮 的 动作 意图 
val confirmIntent = intentFor<NotifyLargeActivity>() 
val piConfirm = PendingIntent .getActivity(this, 
R.string.app name, confirmIintent, 
PendingIntent .FLAG UPDATE CURRENT) 
// 大 视图 通知 需要 通过 NotificationCompat .Builder 来 构建 
val builder = NotificationCompat.Builder (this) 
builder.setSmallIcon (R.drawable.ic app) 
.setTicker ("大 视图 消息 来 啦 ") 
.SetWhen (System. currentTimeMillis()) 
.SetLargeIcon (BitmapFactory.decodeResource (resources, 
R.drawable.ic app)) 
.SetContentTitle (title) 
.setContentText (message) 
.setDefaults (Notification.DEFAULT_ALL) // 设 置 大 视图 通知 的 提醒 方式 
.setStyle (style) // 设 置 大 视图 通知 的 风格 类 型 
.addAction (R.drawable.icon_ cancel，" 取 消 "，picancel) // 添 加 取消 
按钮 及 其 动作 
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.addRction (R.drawable.icon confirm,， "前 往 "，piConfirm) // 添 加 前 


往 按钮 及 其 动作 
val notify = builder.build() 
// 获 取 系统 的 通知 管理 器 


val notifyMgr = getSystemService (Context.NOTIFICRATION_SERVICE) as 
NotificationManager 
notifyMgr.notify(1, notify) 
E 


大 视图 通知 的 推送 效果 如 图 9-15 一 图 9-17 所 示 ， 其 中 图 9-15 展示 大 文本 风格 的 通知 栏 界 面 ， 
图 9-16 展示 大 图 片 风格 的 通知 栏 界 面 ， 图 9-17 展示 收 件 箱 风格 的 通知 栏 界面 。 


喜 大 普 奔 


全 这 是 一 条 大 文字 风格 的 通知 消息 


Wh 人 诠 


年 一 度 的 双 11 开 失败 





图 9-15 大 文本 风格 的 通知 栏 图 9-16 大 图 片 风格 的 通知 栏 图 9-17 收 件 箱 风格 的 通知 栏 
界面 界面 界面 


9.3.3 三 种 特殊 的 通知 类 型 


除了 像 大 视图 通知 那样 拓展 显示 高 度 外 ， 消 息 通知 还 有 其 他 的 几 种 特殊 显示 方式 ， 包 括 进度 
通知 、 浮 动 通知 、 锁 屏 通 知 等 ， 分 别 介绍 如 下 。 
1. 进度 通知 
进度 通知 指 的 是 在 通知 栏 动态 刷新 进度 的 消息 通知 ， 前 面 “9.3.1 通知 推送 Notification ”小 节 
提 到 可 以 通过 setProgress 方法 设置 进度 条 与 当前 进度 ,但 是 该 方法 调用 之 后 仅仅 展示 静态 的 进度 
条 , 要 想 让 进度 值 持续 前 进 , 得 利用 延 时 任务 不 断 刷 新 最 新 的 进度 , 有 关 延 时 任务 的 说 明 参 见 “9.2.1 
任务 Runnable” 小 节 。 
刷新 通知 其 实 很 简单 ， 只 要 反复 发 送 相 同 标识 的 消息 到 通知 栏 即 可 ， 下 面 是 演示 进度 通知 的 
Kotlin 代码 片段 : 
Private val handler = Handler() 
Private var count = 0 
Private var refreshNotify: ProgressNotify? = null 
// 开 始 播放 进度 通知 的 刷新 动画 
private fun startProgressNotify(title: String, message: String) { 
count = 0 
refreshNotify = ProgressNotify(title，message) 


handler .post (refreshNotify) 
toast ("已 推送 到 进度 通知 。") 
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// 定 义 一 个 持续 发 送 进度 通知 的 任务 内 部 类 ， 当 进度 超过 100% 时 任务 停止 
Private inner class ProgressNotify (Private val title: String, private val 
message: String) : Runnable { 
override fun run() { 
sendProgressNotify(title, message, count) 
Count++ 
if (count <= 100) { 
// 若 当前 进度 没有 超过 100%， 则 继续 刷新 通知 栏 上 的 进度 
handler.postDelayed (refreshNotify, 200) 


} 
// 发 送 单 次 进度 通知 。 若 要 不 断 刷 新 进度 ， 则 需 外 部 多 次 调用 该 方法 


Private fun sendProgressNotify (title: String, message: String, progress: 
Int) { 
val clickIntent = intentFor<MainActivity>() 
val piClick = PendingIntent .getActivity(this, 
R.string.app_ name, clickIntent, 
PendingIntent .FLAG_ UPDATE CURRENT) 
// 开 始 构 建 进度 通知 的 各 个 参数 
val builder = Notification.Builder (this) 
builder.setContentIntent (piClick) 
.SetAutoCancel (true) 
.SetSmallIcon (R.drawable.ic app) 
.setTicker ("进度 通知 来 啦 ") 
.SetWhen (System.currentTimeMillis()) 
.SetLargeIcon (BitmapFactory.decodeResource (resources, 
R.drawable.ic app)) 
.SetContentTitle (title) 
.SetContentText (message) 
.setProgress (100，progress，false) // 设 置 进度 条 的 当前 进度 
val notify = builder.build() 
// 获 取 系 统 的 通知 管理 器 
val notifyMgr = getSystemService (Context .NOTIFICATION SERVICE) as 
NotificationManager 
notifyMgr.notify(R.string.app_name, notify) 
E 


进度 通知 的 播放 效果 如 图 9-18 和 图 9-19 所 示 ， 其 中 图 9-18 所 示 为 开始 播放 进度 通知 的 通知 
栏 界面 ， 图 9-19 所 示 为 结束 播放 进度 通知 的 通知 栏 界面 。 


、 。 倒计时 开始 


倒计时 开始 下 午 216 


全 Ready ?GO 1! Ready? GO ! 


图 9-18 进度 通知 开始 播放 图 9-19 进度 通知 结束 播放 
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2. 浮动 通知 
浮动 通知 指 的 是 不 离开 当前 页 面 并 在 屏幕 项 部 悬挂 显示 的 消息 通知 ， 该 功能 需要 Android 5.0 
及 更 高 版 本 的 系统 支持 。 浮 动 通知 的 应 用 场景 挺 广 的 ,包括 但 不 限于 收 到 新 的 短信 、 微 信和 群 有 人 发 
红包 等 。 设 置 浮动 通知 的 关键 是 调用 Notification.Builder 对 象 的 setFullScreenIntent 方法 ， 该 方法 指 
定 了 浮动 窗 的 点 击 事件 以 及 优先 级 。 
下 面 是 演示 浮动 通知 的 Kotlin 代码 片段 : 
Private fun sendFloatNotify(title: String, message: String) { 
toast ("已 推送 到 浮动 通知 。") 
val clickIntent = intentFor<MainActivity>() 
val piClick = PendingIntent .getActivity(this, 
R.string.app name, clickIntent, PendingIntent. 
FLAG UPDATE CURRENT) 
// 开 始 构 建 浮动 通知 的 各 个 参数 


val builder = Notification.Builder (this) 
builder.setContentIntent (piClick) 
.setAutoCancel (true) 
.SetSmallIcon (R.drawable.ic app) 
.setTicker ("浮动 通知 来 啦 ") 
.SetWhen (System.currentTimeMillis()) 
.SetLargeIcon (BitmapFactory.decodeResource (resources, 
R.drawable.ic app)) 
.SetContentTitle (title) 
.SetContentText (message) 
.setFullScreenIntent (piClick，true) // 设 置 浮动 窗 的 点 击 事件 以 及 优先 级 
val notify = builder.build() 
// 获 取 系统 的 通知 管理 器 
val notifyMgr = getSystemService (Context.NOTIFICRTION_SERVICE) as 
NotificationManager 
notifyMgr.notify(R.string.app name, notify) 
是 
浮动 通知 的 推送 效果 如 图 9-20 所 示 ， 此 时 屏幕 项 端 出 现 了 一 条 悬浮 着 的 通知 消息 ， 点 击 该 消 


息 可 执行 对 应 的 页 面 跳 转 动作 。 





2 微 信 群 消息 
全 本 有 人 发 红包 啦 ， 快 来 抢 红包 


微 信 群 消息 
| 有 和 人 发 红包 啦 ， 快 来 抢 红包 | 
发 送 进度 通知 发 送 浮动 通知 














图 9-20 浮动 通知 的 推送 效果 
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3. 锁 屏 通知 
锁 屏 通知 指 的 是 在 锁 屏 界面 依然 提示 通知 内 容 的 消息 通知 ， 该 功能 需要 Android 5.0 及 更 高 版 
本 的 系统 支持 。 设置 锁 屏 通知 的 关键 是 调用 Notification.Builder 对 象 的 setVisibility 方法 , 该 方法 用 
于 指定 通知 消息 在 锁 屏 状态 下 的 显示 方式 ， 显 示 方 式 的 取 值 说 明 见 表 9-4。 
表 9-4 锁 屏 通知 在 锁 屏 状 态 下 的 显示 方式 取 值 说 阴 














Notification 类 的 锁 屏 显示 方式 说 明 

Notification. VISIBILITY_PRIVATE 显示 基本 信息 ， 如 通知 的 图 标 ， 但 隐藏 通知 的 全 部 内 容 
Notification. VISIBILITY_PUBLIC 显示 通知 的 全 部 内 容 

Notification. VISIBILITY_SECRET 不 显示 任何 内 容 ， 包 括 图 标 





下 面 是 演示 锁 屏 通知 的 Kotlin 代码 片段 : 
Private fun sendLockNotify(title: String, message: String, visibile: 
Boolean) { 
if (Build.VERSION.SDK INT < Build.VERSION CODES.LOLLIPOP) { 
toast (" 锁 屏 通知 需要 5.0 以 上 系统 支持 。") 
return 
} else { 
toast ("已 推送 锁 屏 通知 。") 
} 
val clickIntent = intentFor<MainActivity>() 
val piClick = PendingIntent .getActivity(this, 
R.string.app name, clickIntent, 
PendingIntent .FLAG UPDATE CURRENT) 
// 开 始 构 建 锁 屏 通 知 的 各 个 参数 
val builder = Notification.Builder (this) 
builder.setContentIntent (piClick) 
.SetAutoCancel (true) 
.SetSmallIcon (R.drawable.ic_app) 
.setTicker (" 锁 屏 通知 来 啦 ") 
.SetWhen (System. currentTimeMillis()) 
.SetLargeIcon (BitmapFactory.decodeResource (resources, 
R.drawable.ic app)) 
.SetContentTitle (title) 
.SetContentText (message) 
// 设 置 锁 屏 通 知 的 可 见 性 
.SetVisibility(if (visibile) Notification.VISIBILITY PUBLIC 
else Notification.VISIBILITY PRIVATE) 
val notify = builder.build() 
// 获 取 系统 的 通知 管理 器 
val notifyMgr = getSystemService (Context .NOTIFICATION SERVICE) as 
NotificationManager 
notifyMgr.notify(R.string.app name, notify) 
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锁 屏 通知 的 推送 效果 如 图 9-21 所 示 ， 此 时 系统 进入 锁 屏 


状态 ， 并 且 锁 屏 界面 仍旧 展示 着 锁 屏 通知 的 消息 内 容 。 ) 5 2 | 


9.3.4 ”远程 视图 RemoteViews 





11 月 17 日 星期 五 


前 两 个 小 节 介绍 了 消息 通知 的 非常 规 展现 形式 , 但 基本 没 


还 款 提醒 下 午 223 


涉及 通知 内 部 的 布局 格式 。 我 们 知道 页 面 可 以 自己 定义 布局 ， Ee se hers anas 





碎片 也 可 以 自己 定义 布局 ， 乃 至 单个 列表 项 都 能 自己 定义 布 
局 ,那么 消息 通知 能 否 也 自 定义 布局 呢 ? 这 是 肯定 的 ， 不 过 要 ”图 2! 锁 屏 通 知 的 推送 效果 
借助 于 远程 视图 RemoteViews 方 能 实现 。 其 实 Notification.Builder 已 经 提供 了 setContent 方法 ， 该 
方法 就 是 用 来 设置 当前 通知 的 RemoteViews 对 象 , 一旦 调用 了 setContent 方法 ，RemoteViews 对 象 
指定 的 自 定义 布局 就 会 替换 掉 系 统 默 认 的 通知 栏 布局 。 

与 活动 页 面相 比 ， 远 程 视图 是 一 个 不 但 小 型 而 且 简化 了 的 页 面 ， 简 化 的 意思 是 功能 减少 了 ， 
限制 变 多 了 。 虽 然 RemoteViews 与 Activity 一 样 都 有 自己 的 布局 文件 ， 但 是 RemoteViews 的 使 用 
权限 大 幅 缩 小 ， 二 者 之 间 的 区 别 主要 有 : 


(1) RemoteViews 主要 用 于 通知 栏 部 件 和 桌面 部 件 的 布局 ， 而 Activity 用 于 活动 页 面 的 布局 。 

(2) RemoteViews 只 支持 少数 几 种 控件 ， 如 TextView、ImageView、Button、ImageButton、 
ProgressBar、Chronometer( 计 时 器 ) 、AnalogClock〈 模 拟 时 钟 ) 。 

(3) RemoteViews 不 可 直接 获取 和 设置 控件 信息 ， 只 能 通过 该 对 象 的 set 方法 来 修改 控件 
信息 。 


下 面 是 远程 视图 RemoteViews 的 常用 方法 。 


构造 函数 : 创建 一 个 RemoteViews 对 象 。 第 一 个 参数 是 包 名 ， 第 二 个 参数 是 布局 文件 id。 
setViewVisibility: 设置 指定 控件 是 否 可 见 。 

setViewPadding: 设置 指定 控件 的 间距 。 

setTextViewText: 设置 指定 TextView 或 Button 控件 的 文字 内 容 。 
setTextViewTextSize: 设置 指定 TextView 或 Button 控件 的 文字 大 小 。 

setTextColor: 设置 指定 TextView 或 Button 控件 的 文字 颜色 。 
setTextViewCompoundDrawables: 设置 指定 TextView 或 Button 控件 的 文字 周围 图 标 。 
setImageViewResource: 设置 ImageView 或 ImgaeButton 控件 的 资源 编号 。 
setImageViewBitmap: 设置 ImageView 或 ImgaeButton 控件 的 位 图 对 象 。 
setChronometer: 设置 计时 器 信息 。 

setProgressBar: 设置 进度 条 信息 ， 包 括 最 大 值 与 当前 进度 。 

setOnClickPendingIntent: 设置 指定 控件 的 点 击 响应 动作 。 





完成 RemoteViews 对 象 的 构建 与 设置 之 后 ,再 调用 Notification.Builder 对 象 的 setContent 方法 ， 
即 可 完成 自 定义 通知 布局 的 设置 。 下 面 是 一 个 远程 视图 用 到 的 播放 器 通知 布局 文件 例子 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match Parent" 
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android:layout height="match parent" 
android:minHeight="64dp" 
android:orientation="horizontal" > 


<ImageView 
android:layout width="0dp" 
android:layout height="match parent" 
android:layout weight="1" 
android:scaleType="fitCenter" 
android:src="@drawable/tt" /> 


<LinearLayout 
android:layout width="0dp" 
android:layout height="match parent" 
android:layout marginLeft="3dp" 
android:layout marginRight="3dp" 
android:layout weight="4" 
android:orientation="vertical" > 


<ProgressBar 
android:id="@+id/pb_play" 
style="?android:attr/progressBarStyleHorizontal" 
android:layout width="match parent" 
android:layout height="0dp" 
android:layout weight="1" 
android:max="100" 
android:progress="10" /> 


<TextView 
android:id="@+id/tv_ Play" 
android:layout width="match parent" 
android:layout height="0dp" 
android:layout weight="1" 
android:textColor="#ffffff" 
android:textSize="17sp" /> 
</LinearLayout> 


<LinearLayout 
android:layout width="0dp" 
android:layout height="match Parent" 
android:layout weight="1" 
android:orientation="vertical" > 


<Chronometer 
android:id="@+id/chr play" 
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android:layout width="match Parent" 
android:layout height="0dp" 
android:layout weight="1" 
android:gravity="center" /> 


<Button 
android:id="@+id/btn Play" 
android:layout width="match parent" 
android:layout height="0dp" 





android:layout weight="2" 
android:text=" 暂 停 " 
android:textColor="#ffffff" 
android:textSize="15sp" /> 
</LinearLayout> 
</LinearLayout> 


下 面 是 获取 播放 器 通知 布局 的 Kotlin 代码 片段 : 
// 获 取 播 放 器 的 通知 栏 布局 


Private fun getNotifyMusic (ctx: Context, event: String, song: String, isPlay: 
Boolean, progress: Int, time: Long): RemoteViews { 
// 从 notify music.xml 布局 文件 构造 远程 视图 对 象 
val notify music = RemoteViews (ctx.packageName, R.layout.notify _ music) 
if. (isPlay)y { 
notify music.setTextViewText (R.id.btn play, "暂停 ") 
notify music.setTextViewText (R.id.tv play, song + "正在 播放 ") 
notify music.setChronometer (R.id.chr play, time, "%s", true) 
} else { 
notify music.setTextViewText (R.id.btn play, "继续 ") 
notify music.setTextViewText (R.id.tv_play，song + "暂停 播放 ") 
notify music.setChronometer (R.id.chr play, time, "%s", false) 
notify music.setProgressBar(R.id.pb play, 100, progress, false) 
val pIntent = Intent (event) 
val piPause = PendingIntent .getBroadcast( 
ctx, R.string.app name, pIntent, 
PendingIntent .FLAG UPDATE CURRENT) 
// 设 置 暂停 /继续 按钮 的 点 击 动作 对 应 的 广播 事件 
notify music.setOnClickPendingIntent (R.id.btn play, piPause) 
return notify music 


| 


自 定义 通知 栏 的 演示 效果 如 图 9-22 所 示 , 可 以 看 到 播放 器 图 标 在 通知 栏 左边 , 进度 条 在 上 方 ， 
歌曲 名 称 在 下 方 ， 计 时 器 与 控制 按钮 分 布 在 通知 栏 右边 。 
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00:41 
海阔天空 一 Beyond 正 在 播放 





图 9-22 ” 自 定义 通知 栏 的 演示 效果 


9.3.5” 自 定义 折合 式 通知 


前 面 在 “9.3.2 大 视图 通知 ”小 节 提 到 Android 从 4.1 之 后 允许 推送 大 视图 通知 ， 其 实 这 个 大 
视图 的 布局 界面 也 是 能 够 自 定义 的 ， 当 然 依 旧 需 要 借助 远程 视图 RemoteViews 的 力量 。 这 个 自 定 
义 的 大 视图 通知 可 以 看 作 是 一 种 折 装 式 通知 , 在 它 处 于 折合 状态 时 显示 普通 样式 的 通知 内 容 , 在 它 
处 于 展开 状态 时 显示 自 定义 的 大 视图 格式 内 容 。 自 定义 普通 视图 与 自 定义 大 视图 的 设置 方式 参见 表 
9-5 的 说 明 。 


表 9-5 自 定义 普通 视图 与 自 定义 大 视图 的 设置 方式 


二 要 API24 及 以 上 的 设置 方式 
视图 设置 方式 说 明 API24 以 下 的 设置 方式 Notficaton Bullder 的 方法 
Wed mana 
指定 自 定义 的 普通 视图 setCustomContentView 
指定 自 定义 的 展开 视图 Notification 的 bigContentView 属性 | setCustomBigContentView 

下 面 是 获取 播放 器 通知 的 大 视图 布局 Kotlin 代码 片段 : 


Private fun sendCustomNotify (ctx: Context, song: String, contentView: 





RemoteViews, bigContentView: RemoteViews?) { 
// 声 明 一 个 点 击 通知 消息 时 触发 的 动作 意图 
val intent = ctx.intentFor<MainActivity>() 
val contentIntent = PendingIntent .getActivity(ctx, 
R.string.app name, intent, PendingIntent.FLAG UPDATE CURRENT) 
val builder = Notification.Builder (ctx) 
builder.setContentIntent (ContentIntent) 
.setContent (contentView) // 采 用 自 定义 的 通知 布局 
.SetTicker (song) 
.SetSmallIcon (R.drawable.tt_s) 
val notify = builder.build() 
// 正 常 高 度 的 自 定义 通知 
notify.contentView = contentView 
if (bigContentView != null) { 
// 展 开 后 的 自 定义 通知 
notify.bigContentView = bigContentView 
} 
// 获 取 系统 的 通知 管理 器 
val notifyMgr = getSystemService (Context.NOTIFICATION SERVICE) as 
NotificationManager 
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notifyMgr.notify(R.string.app name, notify) 
} 


// 获 取 折叠 视图 展开 后 的 通知 栏 布 局 
Private fun getNotifyExpand(ctx: Context, event: String, song: String, 
isPlay: Boolean, progress: Int, time: Long): RemoteViews { 
// 从 notify expand.xml 布局 文件 构造 远程 视图 对 象 
Val notify expand = RemoteViews (ctx.packageName, 
R.layout.notify expand) 
if (isPlay) { 
notify expand.setTextViewText (R.id.btn Play， "暂停 ") 
notify expand.setTextViewText (R.id.tv play，song + "正在 播放 ") 
notify expand.setChronometer (R.id.chr play, time, "%s", true) 
} else { 
notify expand.setTextViewText (R.id.btn play, "继续 ") 
notify expand.setTextViewText (R.id.tv play，song + "暂停 播放 ") 
notify expand.setChronometer (R.id.chr play, time, "%s", false) 
} 
notify expand.setProgressBar(R.id.pb play, 100, progress, false) 


val pIntent 
val piPause = PendingIntent .getBroadcast( 


Intent (event) 


ctx, R.string.app name, pIntent, 
PendingIntent .FLAG UPDATE CURRENT) 
// 设 置 播放 按钮 的 点 击 动作 对 应 的 广播 事件 
notify expand.setOnClickPendingIntent (R.id.btn play, piPause) 
val bIntent = Intent(ctx, NotifyCustomActivity::class.java) 
val PiBack = PendingIntent .getActivity(ctx, 
R.string.app_name, bIntent, PendingIntent .FLAG UPDATE CURRENT) 
// 设 置 返回 按钮 的 点 击 动作 对 应 的 跳 转 事件 
notify expand.setOnClickPendingIntent (R.id.btn back, piBack) 
return notify expand 


自 定义 折 欠 式 通知 的 演示 效果 如 图 9-23 和 图 9-24 所 示 ， 其 中 图 9-23 所 示 为 展开 状态 时 的 通 
知 栏 界面 ， 图 9-24 所 示 为 折 炙 状态 时 的 通知 栏 界面 。 





海阔天空 一 Beyond 正 在 播放 “ 


00:41 
海阔天空 一 Beyond 正 在 播放 


图 9-23 自 定 义 折 又 式 通知 的 展开 效果 图 9-24 自 定义 折 考 式 通知 的 折 释 效果 
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9.4 _ Service 服务 启 停 


服务 Service 是 Android 的 四 大 组 件 之 一 ， 常 用 在 不 见 其 人 、 但 闻 其 声 的 隐秘 场合 ， 像 上 一 节 
的 通知 推送 用 到 了 系统 的 通知 服务 NOTIFICATION_SERVICE。 既 然 Android 有 自 带 的 系统 服务 ， 
那么 App 也 可 以 有 自己 的 私人 服务 。 对 于 App 自身 的 服务 ， 开 发 者 要 如 何 控制 服务 的 运行 过 程 ? 
使 用 Kotlin 编码 进行 服务 启 停 又 有 哪些 值得 注意 的 地 方 ? 本 节 会 通过 详细 的 讲解 逐步 回答 这 些 
问题 。 














9.4.1 普通 方式 启动 服务 


启动 服务 Service 的 时 机 各 不 相同 ， 既 可 以 在 活动 Activity 中 启动 服务 ， 也 可 以 在 广播 接收 器 
Receiver 中 启动 服务 ， 甚 至 能 够 在 Application 中 启动 服务 。 启 动 服务 的 普通 方式 很 简单 ,使 用 Java 
编码 不 过 下 面 两 行 代码 而 已 : 

Intent intent = new Intent (ServiceNormalActivity.this, 


NormalService.class); 
startService (intent); 


把 上 面 启动 服务 的 Java 代码 直译 为 Kotlin， 翻 译 后 的 Kotlin 代码 如 下 所 示 : 


val intent = Intent (this@ServiceNormalActivity, 
NormalService::class.java) 
startService (intent) 


至 少 表面 看 起 来 这 里 的 Kotlin 编码 跟 Java 编码 半斤八两 。 不 过 倘若 读者 有 心 的 话 ， 定 然 发 现 
第 6 章 的 “6.4.1 传送 配对 字段 数据 ”早已 提 到 了 Anko 库 对 startActivity 的 简化 写法 ， 同 样 Anko 
库 也 提供 了 对 startService 的 简化 写法 ， 故 而 上 述 的 Kotlin 服务 启动 代码 可 以 简写 成 下 面 这 般 : 
startService<NormalService>() 
因为 以 上 的 简化 写法 用 到 了 Anko 库 的 扩展 函数 ， 所 以 必须 先导 入 Anko 库 的 指定 代码 ， 即 在 
kt 文件 头 部 添加 下 面 一 行 导入 语句 ; 
import org.jetbrains .anko.startService 
另外 ， 要 修改 模块 的 build.gradle， 在 dependencies 节点 中 补充 下 述 的 anko-common 包 编译 
配置 : 
compile "org.jetbrains.anko:anko-common: $anko_version" 
启动 服务 的 同时 ， 人 允许 携带 请 求 参 数 传递 给 该 服务 ， 传 送 请 求 参 数 的 Kotlin 服务 启动 代码 如 
下 所 示 : 


startService<NormalService>("request content" to 
et_request.text.toString()) 
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不 过 由 于 服务 既 有 启动 操作 又 有 停止 操作 ， 并 且 停 止 服务 的 时 候 需 要 传 入 原来 启动 服务 时 的 
Intent 对 象 ， 因 此 启动 服务 更 常见 的 做 法 是 : 先 声明 一 个 意图 对 象 ， 然 后 把 它 作为 请 求 参数 在 启动 
服务 时 传 入 ,这 样 停止 服务 时 就 能 传 入 同样 的 意图 对 象 。 按 照 这 个 思路 重新 编码 ， 于 是 形成 了 下 述 
引进 intentFor 函数 的 Kotlin 代码 : 


val intent = intentFor<NormalService>("request content" to 
et_request .text.toString()) 
startService (intent) 


上 面 传输 请 求 参数 时 利用 关键 字 隔 开 参数 名 称 与 参数 值 ， 该 写法 容易 混淆 ,此 时 可 以 采取 Pair 
配对 的 形式 传递 参数 ， 改 写 后 的 Kotlin 启动 服务 代码 如 下 所 示 : 


val intent = intentFor<NormalService>(Pair("request content", 
et_request .text.toString())) 
startService (intent) 


学 习 完 前 面 的 几 种 服务 启动 写法 ， 接 着 通过 完整 的 代码 演示 看 看 Kotlin 操纵 服务 的 全 过 程 ， 
下 面 是 演示 用 的 Kotlin 页 面 代码 : 


class ServiceNormalActivity : AppCompatActivity() { 
var intentNormal: Intent? = null 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout .activity service normal) 
btn_start.setOnClickListener { 
// 第 一 种 写法 ， 参 数 名 和 参数 值 使 用 关键 字 to 隔 开 
intentNormal = intentFor<NormalService>("request content" to 
et_request .text.toString()) 
// 第 二 种 写法 ， 利 用 Pair 把 参数 名 和 参数 值 进行 配对 
//intentNormal = intentFor<NormalService> (Pair("request content", 
et request.text.toString())) 
startService (intentNormal) 
/ /虽然 Anko 库 集 成 了 startService 的 简化 写法 ， 但 是 一 般 不 这 么 调用 
// 因 为 服务 启动 之 后 是 需要 停止 的 ， 按 Anko 的 简化 写法 会 无 法 停止 服务 
// 除 非 无 须 在 代码 中 停止 该 服务 ， 才 可 以 采用 Anko 的 简化 写法 
//startService<NormalService>("request content" to 
et request.text.toString()) 
toast ("普通 服务 已 启动 ") 
} 
btn stop.setOnClickListener { 
if (intentNormal != null) { 
stopService (intentNormal) 


toast ("普通 服务 已 停止 ") 


} 
Normal.tv normal = findViewById<TextView>(R.id.tv normal) 
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companion object Normal { 
Private var tv normal: TextView? = null 
Private Var mDesc = "" 
/ /静态 方法 showText 给 NormalService 内 部 调用 
fun showText (desc: String) { 
mDesc = "${mDesc}${DateUtil.nowTime} $desc\n" 
// 如 果 tv_normal 非 空 才 设置 文本 ， 否 则 不 设置 文本 


tv normal?.text = mDesc 


} 
下 面 是 普通 方式 所 要 启动 的 Kotlin 服务 代码 例子 : 


class NormalService : Service() { 


override fun onCreate() { 
ServiceNormalActivity.showText ("创建 服务 ") 
super.onCreate() 


override fun onStartCommand(intent: Intent, flags: Int, startid: Int): 
rnt 
val bundle = intent.extras 
val request content = bundle.getString("request content") 
ServiceNormalActivity .showText ("启动 服务 ， 收 到 请 求 内 容 : 
${request_content}") 
return Service.START STICKY 


override fun onDestroy() { 
ServiceNormalActivity.showText ("停止 服务 ") 
super.onDestroy() 


override fun onBind (intent: Intent): IBinder? = null 
} 


然后 运行 测试 应 用 ， 呈 现 出 来 的 服务 启 停 效 果 如 图 9-25 和 图 9-26 所 示 ， 其 中 图 9-25 所 示 为 
启动 服务 的 界面 ， 图 9-26 所 为 停止 服务 的 界面 。 
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今天 天 气 :多 云 转 晴 | 人 天 天 气 : 多 云 转 呈 | 
启动 服务 停止 服务 启动 服务 停止 服务 
12:10:08 创建 服务 12:10:08 创建 服务 


10:09 启动 服务 ， 收 到 请 求 内 容 : 今天 天 12:10:09 启动 服务 ， 收 到 请 求 内 容 : 今天 天 
气 : 多 云 转 晴 气 : 多 云 转 晴 
12:10:14 停止 服务 











图 9-25 ”服务 启动 的 效果 图 9-26 服务 停止 的 效果 


9.4.2 ” 绑 定 方式 启动 服务 


9.4.1 小 节 讲 到 了 使 用 普通 方式 启 停 服务 , 其 实 启 停 服务 还 有 另 一 种 绑 定 方式 , 调用 bindService 
方法 表示 绑 定 并 启动 服务 如果 原 来 没有 启动 ) ， 调 用 unbindService 方法 表示 解除 绑 定 并 停止 服 
务 〈 如 果 原 来 没有 启动 ) 。 此 时 一 样 能 够 利用 intentFor 扩展 函数 来 构建 意图 对 象 ， 其 余 的 代码 流 
程 则 基本 跟 Java 保持 一 致 ， 下 面 是 以 绑 定 方式 启动 服务 的 Kotlin 代码 例子 : 


class ServiceBindActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity service bind) 
Bind.tv bind = findViewById<TextView> (R.id.tv_ bind) 
btn_start bind.setOnClickListener { 
val intentBind = intentFor<BindService>("request content" to 
et request.text.toString()) 
// 以 绑 定 方式 启动 服务 
val bindFlag = bindService (intentBind，mFirstConny 
Context .BIND AUTO CREATE) 
Log.d(TAG, "bindFlag=" + bindFlag) 
toast ("服务 已 绑 定 启动 ") 
} 
btn unbind.setOnClickListener { 
if (mBindService != null) { 
// 解 除 绑 定 服务 
unbindService (mFirstConn) 
mBindService = null 


toast ("服务 已 解除 绑 定 ") 


Private var mBindService: BindService? = null 
Private val mFirstConn = object : ServiceConnection { 
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// 获 取 服 务 对 象 时 的 操作 
override fun onServiceConnected (name: ComponentName, service: IBinder) { 
// 如 果 服 务 运行 于 另 一 个 进程 ， 就 不 能 直接 强制 转换 类 型 
// 否 则 会 报错 “java.lang.ClassCastException: android.os.BinderProxy 
cannot be cast to...” 


mBindService = (service as BindService.LocalBinder) .service 
Log.d(TAG, "onServiceConnected") 

} 

// 无 法 获取 服务 对 象 时 的 操作 


override fun onServiceDisconnected (name: ComponentName) { 
mBindService = null 
Log.d(TAG, "onServiceDisconnected") 


companion object Bind { 


Private val TAG = "ServiceBindActivity" 





Private var tv bind: TextView? = null 


Private Var mDesc = "" 





fun showText (desc: String) { 
mDesc = "$mDesc$ {DateUtil.nowTime} $desc\n" 
tv_bind?.text = mDesc 


} 
下 面 是 待 绑 定 / 解 绑 的 Kotlin 服务 代码 例子 : 


class BindService : Service() { 
Private val mBinder = LocalBinder() 


inner class LocalBinder : Binder() { 
Val service: BindService 
get() = thiseBindService 


override fun onCreate() { 
ServiceBindActivity.showText ("创建 服务 ") 
super.onCreate() 


override fun onBind (intent: Intent): IBinder? { 
val bundle = intent.extras 
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val request content = bundle.getString("request_content") 

ServiceBindActivity.showText (" 绑 定 服务 ， 收 到 请 求 内 容 : 
${request content}") 

return mBinder 


override fun onUnbind (intent: Intent): Boolean { 
ServiceBindActivity.showText (" 解 绑 服 务 ") 
return true 
} 
上 述 绑 定 方式 启 停 服务 的 运行 效果 如 图 9-27 和 图 9-28 所 示 ， 其 中 图 9-27 所 示 为 绑 定 服务 之 
后 的 界面 ， 图 9-28 所 示 为 解 绑 服 务 之 后 的 界面 。 


custom custom 








天 气 转 凉 ， 需 要 添 衣 天 气 转 京 ， 需 要 添 衣 








启动 并 绑 定 服务 解 绑 并 停止 服务 启动 并 绑 定 服务 解 绑 并 停止 服务 


12:13:28 创建 服务 12:13:28 创建 服务 
12:13:28 < 收 到 请 求 内 容 : 天 气 转 13: 28 绑 定 服务 ， 收 到 请 求 内容 : 天 气 转 


凉 ， 需 要 添 ， 需 要 添 衣 
位 13:38 解 绑 服 务 





图 9-27 ”服务 绑 定 的 效果 图 9-28 服务 解 绑 的 效果 


9.4.3 ”推送 服务 到 前 台 


前 两 个 小 节 为 了 观察 服务 的 运行 情况 强行 调用 了 Activity 类 的 静态 方法 , 好 让 页 面 显示 服务 的 
运行 情况 。 可 是 这 种 做 法 很 不 安全 ， 因 为 页 面 随时 都 会 跳 转 或 者 干脆 销毁 ， 此 时 服务 就 失去 了 界面 
寄托 。 所 以 更 好 的 做 法 是 ， 不 要 让 服务 依附 于 任何 页 面 ， 服 务 只 管 做 好 自己 ， 而 Android 允许 服务 
以 某 种 形式 出 现在 屏幕 上 ， 这 个 呈现 服务 的 形式 便 是 通知 栏 。 

是 否 让 服务 显示 到 通知 栏 上 面 ， 需 要 在 服务 内 部 执行 下 面 的 两 个 前 台 方法 ， 说 明 如 下 。 

estartForeground: 把 当前 服务 切换 到 前 台 运行 。 第 一 个 参数 表示 通知 的 编号 ， 第 二 个 参数 表示 

Notification 对 象 ， 这 意味 着 切换 到 前 台 就 是 展示 到 通知 栏 。 
@ stopForeground: 停止 前 台 运行 。 参 数 为 true 表示 清除 通知 ， 为 false 表示 不 清除 。 


服务 在 前 台 运 行 的 一 个 常见 应 用 是 音乐 播放 器 ， 即 使 用 户 离开 了 播放 器 页 面 ， 手 机 也 能 在 后 
台 继 续 播放 音乐 , 同时 还 能 在 通知 栏 查看 播放 进度 以 及 控制 播放 与 暂停 操作 。 下 面 是 一 个 音乐 播放 
服务 的 Kotlin 代码 例子 : 

class MusicService : Service() { 


inner class LocalBinder : Binder() { 
val service: MusicService 
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get() = this@MusicService 


Private val mBinder = LocalBinder () 
override fun onBind (intent: Intent): IBinder? = mBinder 





Private var mSong: String = 
Private Var PAUSE EVENT = 
Private var isPlay = true 





Private Var mBaseTime: Long = 0 
Private Var mPauseTime: Long = 0 
Private var mProgress = 0 
Private val handler = Handler() 
Private val PlayTask = object : Runnable { 
override fun run() { 
if (isPlay) { 
if (mProgress < 100) { 
mProgress += 2 
} else { 
mProgress = 0 
} 
handler.postDelayed (this, 1000) 
} 
val notify= getNotify (this@MusicService, PAUSE EVENT, mSong, isPlay, 
mProgress, mBaseTime) 
// 持 续 刷 新 通知 栏 上 的 播放 进度 


startForeground(2, notify) 


Private fun getNotify(ctx: Context, event: String, song: String, isPlay: 
Boolean, progress: Int, time: Long): Notification { 
Val pIntent = Intent (event) 
val nIntent = PendingIntent .getBroadcast (ctx, 

R.string.app_name, pIntent, PendingIntent .FLAG UPDATE CURRENT) 
val notify music = RemoteViews (ctx.packageName, R.layout.notify music) 
if (isPlay) { 

notify music.setTextViewText (R.id.btn play, "暂停 ") 

notify music.setTextViewText (R.id.tv_play, "${song} 正 在 播放 ") 

notify music.setChronometer (R.id.chr play, time, "%s", true) 
} else { 

notify music.setTextViewText (R.id.btn play, "继续 ") 

notify music.setTextViewText (R.id.tv play,，"${song} 暂 停 播 放 ") 

notify music.setChronometer (R.id.chr play, time, "%s", false) 
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notify masic.setProgressBar(R.id.Pb play, 100, progress, false) 
notify msic.setOnClickPendingIntent (R.id.btn play, nIntent) 
val intent = ctx.intentFor<MainActivity>() 
val cIntent = PendingIntent .getActivity(ctx, 

R.string.app_name, intent, PendingIntent.FLAG UPDATE CURRENT) 
val builder = Notification.Builder (ctx) 
return builder.setContentIntent (cIntent) 

.SetContent (notify music) 

.setTicker (song) 

.SetSmallIcon(R.drawable.tt s) .build() 


override fun onStartCommand(intent: Intent, flags: Int, startid: Int): Int { 
mBaseTime = SystemClock.elapsedRealtime() 
isPlay = intent.getBooleanExtral("is play", true) 
mSong = intent.getStringExtra("song") 
handler .postDelayed (playTask, 200) 
return Service.START STICKY 


override fun onCreate() { 
PAUSE_ EVENT = resources.getString(R.string.pause event) 
PauseReceiver = PauseReceiver() 
registerReceiver (pauseReceiver, IntentFilter (PAUSE EVENT)) 
super.onCreate() 


override fun onDestroy() { 
unregisterReceiver (pauseReceiver) 
super.onDestroy() 


Private var pauseReceiver: PauseReceiver? = null 
// 定 义 一 个 处 理 播放 /暂停 事件 的 广播 接收 器 内 部 类 
inner class PauseReceiver : BroadcastReceiver() { 
override fun onReceive(context: Context, intent: Intent?) { 
if (intent != null) { 
isPlay = !isPlay 
(Loplay) { 
handler .postDelayed (playTask, 200) 
if (mPauseTime > 0) { 
val gap = SystemClock.elapsedRealtime() - mPauseTime 
mBaseTime += gap 
. 
} else { 
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mPauseTime = SystemClock.elapsedRealtime () 


| 


上 述 Kotlin 代码 的 与 众 不 同 之 处 在 于 点 击 “ 播 放 /暂停 ”按钮 的 处 理 ， 此 时 触发 的 延迟 意图 对 
象 由 getBroadcast 方法 获得 ， 原 因 是 getActivity 获得 的 对 象 只 会 跳 到 某 个 页 面 ， 要 想 让 触发 的 事件 
作用 于 服务 内 部 ， 只 能 通过 广播 的 方式 。 

下 面 是 启动 和 停止 音乐 播放 服务 的 Kotlin 页 面 代码 示 例 : 





class NotifyServiceActivity : AppCompatActivity() { 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout .activity notify service) 
Var bPlay = false 
btn send service.setOnClickListener { 
bPlay = !bPlay 
// 声 明 携 带 两 个 输入 参数 的 意图 对 象 
val intent = intentFor<MusicService>("is play" to bPlay, 
"song" to et_song.text.toString()) 
if (bPlay) { 
startService (intent) 
toast ("歌曲 $ {et_song.text} 已 在 通知 栏 开始 播放 ") 
btn_send_service.text = "停止 播放 音乐 " 
] else' { 
StopService (intent) 
toast (" 歌 曲 $ {et_song.textj} 已 从 通知 栏 清除 ") 
btn send service.text = "开始 播放 音乐 " 


} 


音乐 播放 服务 的 前 台 运行 效果 如 图 9-29 和 图 9-30 所 示 ， 其 中 图 9-29 所 示 为 正在 播放 中 的 通 
知 栏 界 面 ， 图 9-30 所 示 为 暂停 播放 时 的 通知 栏 界面 。 


是 00:11 耽 00:49 
家 北京 欢迎 你 正在 播放 EI 是 北京 欢迎 你 暂停 播放 E3 


图 9-29 正在 播放 中 的 通知 栏 界面 图 9-30 ”暂停 播放 时 的 通知 栏 界面 
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9.5 ”实战 项 目 : 电 商 App 的 生 鲜 团购 


现在 的 电子 商务 App 几乎 是 无 所 不 卖 ， 从 服装 到 图 书 ， 从 家 电 到 家 具 ， 从 数码 到 日 用 品 ， 越 
来 越 多 的 商品 在 网 上 销售 。 然而， 有 一 大 品类 的 商品 领域 迟 迟 未 能 诞生 独 角 曾 公司 ,这 便 是 生 鲜 电 
商 。 即 使 巨头 打造 了 盒 马 鲜 生 、 京 东 到 家 等 业态 ， 也 没有 实现 市 场 的 成 熟化 ， 这 是 为 什么 呢 ? 由 于 
生 鲜 有 着 与 其 他 商品 不 同 的 特点 ， 比 如 生 鲜 的 保质 期 很 短 , 造成 商家 无 法 长 期 储存 ; 又 比如 生 鲜 的 
价格 受 时 令 影 响 ， 容 易 起 伏 波动 ; 再 比如 生 鲜 的 销售 是 讲究 规模 的 ， 大 量 批发 才 有 利 可 图 等 。 因 此 
这 些 特点 决定 了 生 鲜 产品 无 法 像 其 他 商品 那样 采取 常规 方式 销售 ， 而 必须 采用 新 方式 进行 销售 , 新 
的 销售 方式 建议 具备 “预订 + 团购 + 统一 发 货 ” 的 特征 ， 从 而 既 摊 薄 顾客 的 成 本 又 降低 商家 的 风险 。 
本 章 结尾 通过 “ 电 商 App 的 生 鲜 团购 ”这 个 实战 项 目 详细 分 析 如 何 利用 App 开发 实现 生 鲜 团购 的 
相关 功能 。 








9.5.1 需求 描述 


需求 分 析 不 是 一 个 轻松 的 活 儿 ， 因 为 首先 要 表达 清楚 没有 遗漏 功能 ， 其 次 要 循循善诱 ， 让 技 
术 人 员 明 白 这 是 什么 事 儿 ， 再 次 还 得 有 条 理 、 成 体系 ， 方 便 做 出 原型 来 。 既 然 如 此 ， 不 妨 先 看 几 张 
界面 效果 图 ， 有 个 直观 印象 更 容易 产生 联想 。 生 鲜 团 购 的 页 面 一 进来 就 展示 几 个 热卖 食品 ， 先 声 夺 
人 ， 紧 紧 抓 住 吃 货 们 的 眼球 ， 如 图 9-31 所 示 ， 这 是 生 鲜 食品 的 列表 页 面 ， 鲜 攀 的 大 闸 蟹 和 小 龙虾 
美食 令 人 垂 洗 欲 满 ， 把 列表 页 往 上 拉 ， 继 续 展示 剩余 的 虾 类 以 及 名 贵 鱼 类 的 装 长 大 餐 ， 如 图 9-32 
所 示 。 








阳澄湖 大 闸 蟹 A 


My 青岛 皮 皮 是 
价格 : 999 元 


a 平 潭 红 饲 





价格 :666 元 已 有 500 人 参 团 
波士顿 大 龙 是 
Ds ts. 666 元 500 人 大 Rs 
阿拉 斯 加 这 于 蟹 es a 


价格 : 888 元 














鲜 活 大 虾 
盱眙 小 龙虾 


价格 : 999 元 50 
My 青鸟 皮 皮 是 





价格 : 666 元 


-zt 波士顿 大 龙虾 





























9-31 生 鲜 食品 的 列表 页 面 效果 9-32” 生 鲜 列表 上 拉 之 后 的 界面 
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看 到 一 款 令 人 心仪 已 久 的 阳澄湖 大 疗 蟹 ， 点 击 它 跳 到 大 闻 蟹 的 详情 页 面 ， 可 见 当 前 已 有 500 
人 加 入 团购 ， 如 图 9-33 所 示 。 还 有 什么 能 阻挡 吃 货 们 的 大 快 条 颐 呢 ? 赶紧 点 击 “ 立 即 参 加 团购 
按钮 ， 页 面 提示 成 功 参 团 〈 已 团购 人 数 加 一 ) ， 如 图 9-34 所 示 。 


























立即 参加 团购 





图 9-33 生 鲜 食品 的 详情 页 面 图 9-34 ”参加 团购 后 的 详情 页 
可 惜 未 达到 团购 的 目标 人 数 ， 还 需 耐 心 等 待 其 他 人 的 加 入 。 但 是 用 户 又 不 可 能 一 直 停 留 在 这 
个 团购 页 面 ， 因 此 应 当 由 App 自己 想 办 法 实时 获取 参 团 人 数 ， 并 将 最 新 的 参 团 人 数 推送 到 通知 栏 ， 
方便 用 户 时 不 时 地 关心 一 下 ， 通 知 栏 的 推送 效果 如 图 9-35 所 示 。 随 着 时 间 的 流逝 ， 终 于 在 某 个 时 
刻 参 团 人 数 达 到 1000 人 ， 此 时 系统 赶忙 震动 手机 提醒 用 户 ， 如 图 9-36 所 示 。 


| | 二 oo 
图 9-35 团购 人 数 实时 获取 中 图 9-36 ”团购 人 数 已 达 组 团 要 求 





正常 组 团 成 功 之 后 ， 还 要 用 户 支付 定金 ， 如 此 才 算 完成 生 鲜 团 购 的 预订 流程 。 不 过 这 里 仅仅 
是 练 手 而 已 ， 所 以 能 够 实现 上 述 的 界面 效果 即 可 。 











9.5.2 ”开始 热身 ; 震动 器 Vibrator 





9.5.1 小 节 的 需求 描述 提 到 ， 团 购 人 数 达 到 目标 数量 时 ,手机 要 立即 震动 ， 提 示 用 户 组 团 成 功 。 
使 用 震动 器 要 在 AndroidManifest.xml 中 加 入 如 下 权限 : 
SI B= 
<uses-permission android:name="android.permission.VIBRATE" /> 
让 手机 震动 的 功能 用 到 了 震动 器 Vibrator 类 , 而 震动 器 对 象 从 系统 服务 VIBRATOR_SERVICE 获得 ， 
实现 该 功能 的 代码 很 简单 ， 即 便 用 Java 书写 也 只 有 以 下 两 行 代码 : 
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Vibrator vibrator = (Vibrator) getSystemService 
(Context .VIBRATOR SERVICE); 
Vibrator.vibrate(3000) 7 


两 行 代码 看 起 来 真 没 什么 好 简化 的 了 ， 因 为 转换 成 Kotlin 也 要 下 面 的 两 行 代码 : 


// 常 规 做 法 : 从 系统 服务 中 获取 震动 器 对 象 
val vibrator = getSystemService (Context .VIBRATOR SERVICE) as Vibrator 
vibrator.vibrate (3000) 


虽然 获取 震动 器 的 代码 并 不 多 , 但 是 这 真 的 很 难 记忆 ， 首 先 开 发 者 要 调用 getSystemService 方 
法 ， 接 着 绞 尽 脑汁 才能 想起 该 服务 的 名 称 是 VIBRATOR_SERVICE， 最 后 将 类 型 强制 转换 为 
Vibrator。 其 中 ， 即 有 大 写字 母 又 有 小 写字 母 还 有 大 小 写 混合 ， 对 于 英文 不 溜 的 朋友 来 说 ， 这 简直 
是 个 灾难 。 如 果 只 要 一 个 朗朗 上 口 的 单词 就 能 代表 震动 器 , 那 势必 会 为 开发 者 省 去 背诵 专业 英语 单 
词 的 麻烦 。 然 而 两 行 代码 还 能 怎么 优化 ? 倘若 改造 成 工具 类 获取 震动 器 对 象 ， 也 不 见得 一 定 省 事 。 

不 过 Kotlin 可 不 会 善 罢 甘 休 ， 相 反 是 迎 难 而 上 ， 因 为 它 坐 拥 扩展 函数 这 个 法 宝 ， 之 前 我 们 多 
次 见识 了 扩展 函数 的 威力 ， 比 如 提示 窗 的 toast、 提 醒 对 话 框 的 alert 等 。 当 然 ， 获 取 震 动 器 对 象 也 
能 按照 扩展 函数 来 改造 ， 比 如 给 Context 添加 一 个 扩展 函数 getVibrator， 该 扩展 函数 的 Kotlin 代码 
示例 如 下 : 

// 获 取 震 动 器 

fun Context .getVibrator () : Vibrator { 

return getSystemService (Context.VIBRRATOR_SERVICE) as Vibrator 
} 


接着 回 到 Activity 页 面 代码 ， 实 现 震 动 功能 只 需 下 面 的 一 行 代码 : 


// 利 用 扩展 函数 获得 震动 器 对 象 
getVibrator () .vibrate (3000) 


以 上 代码 固然 简化 了 ， 却 仍然 不 是 最 简单 的 写法 ， 看 看 getVibrator() 方 法 ， 前 面 有 get 后 面 有 
括号 ， 都 是 碍 手 碍 脚 的 家 伙 。 可 去 掉 括号 就 不 是 函数 了 ， 而 变 成 了 属性 ， 难 不 成 Kotlin 什么 时 候 
多 了 个 扩展 属性 的 用 法 ? 其 实 Kotlin 还 真 的 可 以 实现 扩展 属性 的 功能 ， 关 键 是 要 利用 扩展 函数 进 
行 移花接木 。 首 先 要 在 kt 文件 中 声明 一 个 Context 类 的 新 属性 ， 然 后 定义 该 属性 的 get 方法 (get 
方法 为 扩展 函数 ) 。 如 此 一 来 ， 外 部 访问 该 扩展 属性 时 ， 编 译 器 会 自动 调用 该 属性 的 get 方法 ， 从 
而 通过 扩展 函数 间接 实现 扩展 属性 。 

接 下 来 依旧 以 震动 器 为 例 ， 看 看 如 何 使 用 Kotlin 代码 声明 扩展 属性 vibrator: 

// 获 取 震 动 器 

// 利 用 扩展 函数 实现 扩展 属性 ， 在 Activity 代码 中 即 可 直接 使 用 vibrator 

val Context .vibrator : Vibrator 

get () = getSystemService (Context.VIBRATOR_SERVICE) as Vibrator 


现在 回 到 Activity 代码 ， 只 要 通过 vibrator 就 能 访问 震动 器 的 方法 ， 如 下 所 示 : 


// 利 用 扩展 函数 实现 扩展 属性 ， 直 接 使 用 vibrator 即 可 指 代 震 动 器 对 象 
vibrator.vibrate (3000) 
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当然 , 要 想 正 常 访问 自 定义 的 扩展 函数 和 扩展 属性 , 需要 在 Activity 代码 头 部 加 入 以 下 的 导入 
语句 : 


import com.example.custom.util.vibrator 


除了 震动 器 之 外 ， 其 他 从 系统 服务 获得 对 象 的 管理 器 也 能 照 此 办 理 ， 壁 如 本 章 “9.3 自 定义 通 
知 栏 ” 提 到 的 通知 管理 器 NotificationManager， 按 照 之 前 的 调用 方式 是 下 面 的 Kotlin 代码 : 


val notifyMgr = getSystemService(Context .NOTIFICATION SERVICE) as 
NotificationManager 
notifyMgr.notify(R.string.app name, notify) 


显然 ， 通 知 管理 器 对 象 的 获取 代码 更 兄长 ， 接 下 来 将 其 改造 为 扩展 属性 的 方式 ， 则 相应 的 
Context 扩展 代码 如 下 所 示 : 


// 获 取 通 知 管理 器 
// 试 试 在 Activity 代码 中 调用 “notifier.notify(R.string.app_name, notify)” 
val Context.notifier: NotificationManager 

get() = getSystemService (Context .NOTIFICATION SERVICE) as 


NotificationManager 
原来 获取 通知 管理 器 的 两 行 代码 便 缩减 为 下 面 的 一 行 Kotlin 代码 了 : 
notifier.notify(R.string.app_name, notify) 


举一反三 ， 来 自 系统 服务 的 其 余 管理 器 统统 运用 扩展 属性 ， 能 够 更 加 方便 将 来 的 开发 工作 。 
下 面 是 几 个 常用 管理 器 通过 扩展 属性 改写 后 的 Kotlin 实现 代码 : 


// 获 取 下 载 管 理 器 
val Context.downloader: DownloadManager 
get() = getSystemService (Context .DOWNLOAD SERVICE) as DownloadManager 
// 获 取 定 位 管理 器 
val Context.locator: LocationManager 
get() = getSystemService (Context .LOCATION SERVICE) as LocationManager 
// 获 取 连 接管 理 器 
Val Context.connector: ConnectivityManager 
get() = getSystemService (Context .CONNECTIVITY SERVICE) as 
ConnectivityManager 
// 获 取 电 话 管理 器 
Val Context .telephone: TelephonyManager 
get() = getSystemService (Context .TELEPHONY_SERVICE) as TelephonyManager 
// 获 取 无 线 管理 器 
val Context .wifi: WifiManager 
get () = getSystemService (Context .WIFI SERVICE) as WifiManager 
// 获 取 闹 钟 管理 器 
val Context .alarm: AlarmManager 
get () = getSystemService (Context.ALRARM SERVICE) as AlarmManager 
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// 获 取 音 频 管理 器 
val Context.audio: AudioManager 
get () = getSystemService (Context .AUDIO SERVICE) as AudioManager 


9.5.3 ”控件 设计 


正如 生 鲜 团购 是 个 崭新 的 事物 ， 这 里 的 实战 项 目 用 到 了 多 个 重新 定义 的 控件 ， 其 实 也 不 必 标 
新 立 异 ,只 要 把 本 章 前 面 介绍 过 的 自 定 义 控件 直接 拿 过 来 , 复习 复习 它们 的 实现 步骤 及 其 用 法 即 可 。 
这 些 相关 的 自 定 义 控件 概述 如 下 。 
@ 不 滚动 列表 视图 NoScrollListView: 一 个 页 面谈 入 多 个 列表 ,每 个 列表 都 要 完全 展示 ， 只 能 使 
用 自 定义 的 NoScrollListView。 
e 圆 角 布局 RoundLayout: 每 个 列表 内 的 商品 都 属于 同一 种 类 ， 最 好 能 够 与 周围 区 域 通过 界线 
分 隔 开 ， 暂 时 采用 RoundLayout。 
@ 进度 条 ProgressBar: 商品 详情 页 面 可 展示 团购 进度 ， 通 知 栏 上 也 可 展示 团购 进度 ， 二 者 都 用 
到 了 进度 条 ProgressBar。 
@ 任务 Runnable: 要 想 通 过 动画 形式 泻 染 团购 人 数 的 当前 进度 ， 可 利用 任务 Runnable 持续 刷新 
进度 条 。 
”通知 推送 Notification: 把 团购 信息 推送 到 通知 栏 ， 需 要 采用 通知 推送 Notification 。 
@ ”远程 视图 RemoteViews: 自 定义 的 消息 通知 必须 经 由 RemoteViews 实现 该 通知 的 控件 布局 。 
除了 上 面 的 几 个 自 定 义 控件 外 ， 按 照 效果 图 还 需要 一 个 团购 服务 在 后 台 运 行 ， 模 拟 团购 信息 
的 实时 刷新 效果 。 另 外 ， 本 项 目 还 使 用 了 几 个 系统 服务 ， 结 合 App 自 定 义 的 服务 说 明 如 下 。 
@ ”服务 Service: 后 台 运行 的 团购 服务 不 但 要 模拟 团购 信息 的 实时 交互 ， 而 且 要 借助 通知 栏 推送 
到 前 台 展 示 给 用 户 观看 。 
@ 通知 管理 器 NotificationManager: 通知 管理 器 的 对 象 实例 从 系统 服务 NOTIFICATION_ 
SERVICE 中 获得 ， 它 用 于 管理 通知 的 推送 与 回收 。 
@ 震动 器 Vibrator: 震动 器 的 对 象 实例 从 系统 服务 VIBRATOR_SERVICE 中 获得 ， 它 用 于 控制 
手机 震动 的 时 长 。 


县 一 且 着 实 不 简单 ， 别 看 生 鲜 团购 貌似 只 有 两 个 页 面 ， 实 际 上 用 到 的 开发 技术 却 不 少 。 





9.5.4 ”关键 代码 


为 了 方便 读者 更 好 、 更 快 地 使 用 Kotlin 编码 完成 生 鲜 团购 项 目 ， 下 面 列举 几 个 重要 功能 的 
Kotlin 代码 片段 。 


1. 关于 初始 化 生 鲜 商品 的 列表 信息 

因为 一 个 页 面 可 能 展示 多 个 生 鲜 列表 ， 所 以 每 个 生 鲜 列表 需要 使 用 “9.1.2 测量 尺寸 ”小 节 提 
到 的 不 滚动 列表 视图 NoScrollListView 来 展示 。 另 外 , 构造 生 鲜 商 品 的 列表 数据 可 采用 Kotlin 增强 
了 的 可 变 队列 MutableList， 且 队列 中 的 每 项 记录 可 以 采取 命名 参数 来 声明 。 
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下 面 是 初始 化 生 鲜 列表 的 Kotlin 代码 示例 : 
private fun initCrabList() { 
val freshList = mutableListOf<FreshInfo>( 
FreshInfo (name = "阳澄湖 大 闸 蟹 "， 
desc = " 产 自 阳澄湖 的 天 然 大 闻 拨 ， 口 味 一 流 ， 认 淮 阳 漆 湖 。"， 
imageId = R.drawable.dazhaxie, 
Price = 999, peopleCount = 500 )， 
FreshInfo (name = " 平 潭 红 印 "， 
desc = " 谊 红 肉 肥 的 句 缘 青 蟹 ， 滋 补 强身 ， 平 潭 特产 。"， 
imageId = R.drawable.hongxun, 
Price = 666, peopleCount = 500 )， 
FreshInfo (name = "阿拉 斯 加 帝王 蟹 "， 
desc = "来 自 大 自然 的 馈赠 ， 阿 拉 斯 加 当地 深海 捕捞 。"， 
imageId = R.drawable.diwangxie, 
Price = 888, peopleCount = 500 ) ) 
val adapter = FreshAdapter (this, freshList) 
nslv_crab.adapter = adapter 
nslv_crab.onItemClickListener = adapter 


3 
2. 关于 携带 生 鲜 信息 跳 转 至 详情 页 面 
在 生 鲜 列表 页 面 ， 点 击 某 个 生 鲜 商品 会 跳 转 到 该 商品 的 详情 页 面 ， 在 跳 转 的 同时 要 携带 生 鲜 
信息 的 参数 。 围 绕 这 个 参数 的 携带 过 程 ，Kotlin 代码 应 当 进 行 以 下 修改 : 
(1) 定 义 一 个 生 鲜 信息 的 Parcelable 类 , 并 使 用 注解 <@Parcelize ”修饰 该 类 。 下 面 是 Parcelable 
类 的 Kotlin 定义 代码 〈 若 函数 体 没 有 代码 ， 则 可 省 略 函数 体 的 大 括号 ) : 





@Parcelize 
data class FreshInfo (var name: String="", var desc: String="", var imageId: 


Int=0, 
Var price: Int=0, var peopleCount: Int=0, var isJoin: 
Boolean=false) : Parcelable 
(2) 在 列表 适配器 中 执行 页 面 跳 转 动作 ， 可 利用 Anko 库 的 startActivity 函数 完成 跳 转 操作 ， 
下 面 是 Kotlin 的 页 面 跳 转 代码 例子 : 
context .startActivity<FreshDetailActivity>("fresh" to fresh) 
(3) 详情 页 面 调用 Intent 对 象 的 getParcelableExtra 方法 读 取 列表 页 传 来 的 生 鲜 数据 ， 下 面 是 
Kotlin 读 取 请 求 参 数 的 代码 例子 : 
Var freshInfo: FreshInfo = intent.getParcelableExtra("fresh") 
3. 关于 提前 终止 进度 条 动画 的 播放 
用 户 在 生 鲜 详 情 页 面 点 击 “ 立 即 参 加 团购 ”按钮 后 ， 界 面 上 的 进度 条 动画 应 当 立 即 停止 ， 并 
且 进 度 条 文字 上 的 团购 数量 同时 加 一 。 此 时 肯定 要 调用 处 理 器 Handler 对 象 的 removeCallbacks 方 
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法 来 回收 Runnable 任务 ， 另 外 要 延迟 一 定时 间 再 去 设置 进度 条 上 的 团购 文本 ， 避 免 任务 
步 处 理 造成 代码 的 执行 顺序 产生 混乱 。 
下 面 是 停止 进度 动画 《 即 回收 任务 对 象 ) 的 Kotlin 代码 : 


handler.removeCallbacks (animation) 


五 


收 的 异 








handler .postDelayed ({ 
tpb count.progress = (count+1)*100/TOTAL 
tpb_count .progressText = "当前 已 有 ${count+1} 人 加 入 团购 " 
tpb_count .invalidate() // 进 度 条 属性 发 生变 化 ， 调 用 invalidate 方法 立即 刷新 当 
前 进度 
}, 100) 


4. 关于 携带 团购 信息 启动 团购 服务 

用 户 点 击 “ 立 即 参加 团购 ”按钮 ， 此 时 后 台 自 动 启动 团购 服务 ， 并 模拟 与 服务 器 的 团购 信息 
交互 , 为 此 也 要 把 团购 信息 传递 给 团购 服务 。 这 里 依旧 利用 Anko 库 的 startService 函数 完成 服务 启 
动 操作 ， 具 体 的 Kotlin 启动 代码 如 下 所 示 : 


startService<GroupService>("fresh" to freshInfo) 
5. 关于 服务 销毁 时 回收 通知 推送 
如 果 用 户 退出 电 商 App， 那 么 为 了 减少 系统 资源 消耗 ， 可 在 团购 服务 销毁 时 回收 通知 栏 上 的 
团购 消息 。 回 收服 务 通知 的 Kotlin 代码 示例 如 下 : 


override fun onDestroy() { 

















super.onDestroy() 
if (notify != null) { 

stopForeground (true) // 停 止 前 台 运 行 的 同时 清除 通知 
} 


9.6 小 结 


本 章 主要 介绍 了 Kotlin 如 何 完成 几 种 自 定义 控件 的 实现 过 程 ， 包 括 自 定义 普通 视图 的 三 个 步 
又 (构造 对 象 、 测 量 尺 寸 、 绘 制 部 件 )、 简 单 动画 的 自 定 义 实现 (任务 Runnable、 进 度 条 ProgressBar 
以 及 进度 条 动画 的 实现 ) 、 通 知 推送 的 展现 形式 (常规 通知 、 大 视图 通知 、 三 种 特殊 通知 、 自 定义 
通知 、 折 登 式 通知 ) 以 及 Service 服务 组 件 的 启 停 方式 〈 普 通 启 停 、 绑 定 与 解 绑 、 推 送 到 前 台 ) 。 
最 后 设计 了 一 个 实战 项 目 “ 电 商 App 的 生 鲜 团购 ”， 在 该 项 目的 Kotlin 编码 中 采用 了 前 面 介绍 的 
部 分 自 定义 控件 以 及 Service 服务 的 启 停 和 推送 ， 另 外 还 介绍 了 Kotlin 对 震动 器 用 法 的 改进 编码 。 
通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 5 种 开发 技能 : 


(1) 学 会 使 用 Kotlin 完成 自 定义 视图 的 实现 过 程 ， 除 了 构造 对 象 、 测 量 尺 寸 、 绘 制 部 件 的 三 
大 步骤 之 外 ， 重 点 掌握 Kotlin 的 主 构造 函数 和 注解 “@JvmOverloads” 在 自 定义 视图 中 的 运用 。 
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(2) 学 会 使 用 Kotlin 实现 简单 的 自 定义 动画 ， 重 点 掌握 Kotlin 对 任务 对 象 Runnable 的 4 种 
定义 方式 ， 并 利用 Runnable 实现 简单 的 进度 条 动画 。 

(3) 学 会 使 用 Kotlin 展示 不 同形 式 的 消息 通知 ， 包 括 常规 通知 、 大 视图 通知 、 三 种 特殊 通知 
(进度 通知 、 浮 动 通知 、 锁 屏 通知 ) 、 自 定义 通知 、 折 羡 式 通知 等 。 

(4) 学 会 使 用 Kotlin 运用 Service 服务 的 三 种 启 停 方式 ， 包 括 普通 方式 的 启 停 、 绑 定 方式 的 
启 停 、 推 送 到 通知 栏 与 从 通知 栏 回收 ， 重 点 掌握 Kotlin 如 何 携带 请 求 参数 启动 服务 。 

(5) 学 会 使 用 Kotlin 的 扩展 函数 特性 实现 扩展 属性 ， 并 运用 扩展 属性 简化 各 种 系统 管理 器 的 
实例 获取 写法 。 


Kotlin 实现 网 络 通信 


本 章 将 介绍 Kotlin 实现 网 络 通信 功能 的 相关 技术 , 包括 多 线程 技术 的 运用 、HTTP 接口 的 访问 
操作 、 文 件 下 载 的 处 理 方式 ， 另 外 还 将 介绍 安 卓 四 大 组 件 之 一 内 容 提供 器 ContentProvider 的 常见 
用 法 。 最 后 结合 本 章 所 学 的 知识 演示 一 个 实战 项 目 “ 电 商 App 的 自动 升级 ”的 设计 与 实现 。 


10.1 多 线程 技术 


手机 应 用 与 传统 软件 有 一 个 很 大 的 区 别 ， 就 是 App 很 讲究 画面 的 流畅 度 ， 毕 竟 手 机 屏幕 只 
豆腐 块 略 大 一 些 , 在 这 有 限 的 方寸 之 间 ,， 如果 发 生 卡 顿 乃 至 卡 死 的 情况 ， ea 
忍受 的 。 因此， 为 了 保证 App 画面 的 流畅 ， 同 时 也 要 兼顾 事务 的 正常 处 理 ， 引 进 多 线程 技术 便 是 
不 可 或 缺 的 了 。 但 是 Android 又 规定 分 线程 不 能 直接 操作 界面 控件 ， 于 是 围绕 着 如 何 启动 分 线程 、 
如 何 维持 线程 间 的 信息 交互 , 从 而 衍生 出 处 理 器 消息 机 制 、 进 度 对 话 框 提示 、 异步 任务 处 理 等 技术 。 
接 下 来 本 节 将 对 这 些 多 线程 相关 技术 进行 深入 的 分 析 和 介绍 。 


10.1.1 大 线程 Thread 与 消息 传递 


App 开发 时 常会 遇 到 一 些 耗 时 的 业务 场景 ， 比 如 后 台 批量 处 理 数 据 、 访 问 后 端 服务 器 接口 等 ， 
此 时 为 了 保证 界面 交互 的 及 时 响应 ， 必 须 通过 分 线程 单独 运行 这 些 耗 时 任务 。 简 单 的 线程 可 使 用 
Thread 类 来 启动 ， 无 论 是 Java 还 是 Kotlin 都 一 样 ， 该 方式 首先 要 声明 一 个 自 定义 线程 类 ， 对 应 的 
Java 代码 如 下 所 示 : 
Private class PlayThread extends Thread { 


@Override 
public void run() { 
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// 此 处 省 略 具体 的 线程 内 部 代码 


和 
自 定义 线程 类 的 Kotlin 代码 与 Java 大 同 小 异 ， 具 体 如 下 : 


Private inner class PlayThread : Thread() { 


override fun run() { 


// 此 处 省 略 具体 的 线程 内 部 代码 
} 


线程 类 声明 完毕 ,接着 要 启动 线程 处 理 任 务 ,在 Java 中 调用 一 行 代码 “new PlayThread0.start();” 
即 可 ， 至 于 Kotlin 则 更 简单 ， 只 要 调用 “PlayThread().start()” 就 行 。 如 此 看 来 ，Java 的 线程 处 理 代 
码 跟 Kotlin 差 不 了 多 少 ， 没 发 觉 Kotlin 比 Java 有 什么 优势 。 倘 使 这 样 ， 真 是 小 瞧 了 Kotlin， 它 身 
怀 多 项 绝技 , 单单 是 匿名 实例 这 招 ,之 前 在 “9.2.1 任务 Runnable ”小节 便 领教 过 了 , 同样 线程 Thread 
也 能 运用 匿名 实例 方式 化 繁 为 简 。 注 意 到 自 定义 线程 类 均 需 由 Thread 派生 而 来 ， 然 后 必须 且 仅 需 
重 写 run 函数 ， 所 以 像 类 继承 、 函 数 重 载 这 些 代码 都 是 走过场 ， 完 全 没 必 要 每 次 都 依 样 画 葫芦 ， 编 
译 器 真正 关心 的 只 是 run 函数 内 部 的 具体 代码 。 

于 是 ， 借 助 匿名 实例 的 手段 ，Kotlin 的 线程 执行 代码 可 以 简写 成 下 面 这 般 : 

Thread { 
// 此 处 省 略 具体 的 线程 内 部 代码 
}.start () 

以 上 的 Kotlin 代码 段 看 似 无 理 ， 实 则 有 规 ， 不 但 指明 这 是 个 线程 ， 而 且 命令 启动 该 线程 ， 可 
谓 是 简洁 明了 。 

线程 代码 在 运行 过 程 中 ， 通 常 还 要 根据 实际 情况 来 更 新 界面 ， 以 达到 动态 刷新 的 效果 。 可 是 
Android 规定 了 只 有 主线 程 才能 操作 界面 控件 ， 分 线程 是 无 法 直接 使 用 控件 对 象 的 ， 只 能 通过 
Android 提供 的 处 理 器 Handler 才能 间接 操纵 控件 。 这 意味 着 ， 要 想 让 分 线程 持续 刷新 界面 ， 仍 需 
完成 传统 Android 开发 的 下 面 几 项 工作 : 

(1) 声明 一 个 自 定义 的 处 理 器 类 Handler， 并 重 写 该 类 的 handleMessage 函数 ， 根 据 不 同 的 消 
息 类 型 进行 相应 的 控件 操作 。 
(2) 线程 内 部 针对 各 种 运行 状况 ， 调 用 处 理 器 对 象 的 sendEmptyMessage 或 者 sendMessage 

方法 发 送 事先 约定 好 的 消息 类 型 。 

举 个 具体 的 业务 例子 ， 现 在 有 一 个 新 闻 版 块 ， 每 隔 两 秒 在 界面 上 滚动 播报 新 闻 ， 其 中 便 联 合 
运用 了 线程 和 处 理 器 ， 先 由 线程 根据 实际 情况 发 出 消息 指令 ， 再 由 处 理 器 按照 消息 指令 轮 播 新 闻 。 
详细 的 Kotlin 页 面 代码 示例 如 下 : 


Class MessageActivity : AppCompatActivity() { 








Private Var bPlay = false 

private val BEGIN = 0 // 开 始 播放 新 闻 
private val SCROLL = 1 // 持 续 滚动 新 闻 
private val END = 2 // 结 束 播放 新 闻 
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private val news = arrayOf(" 北 斗 三 号 卫星 发 射 成 功 ， 定 位 精度 媲美 GPS"， "美国 赌 城 拉 
斯 维 加 斯 发 生 重大 枪击 事件 "，“" 日 本 在 越南 承建 的 跨 海 大 桥 未 建 完 已 下 沉 "， "南水北调 功 在 当代 ， 数 亿 人 
喝 上 长 江水 "， "马克 龙 呼 吁 重建 可 与 中 国 匹敌 的 强大 欧洲 ") 


override fun onCreate (savedInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 
setContentView (R.layout .activity message) 
// 指 定 文本 视图 内 部 文本 的 对 齐 方式 为 靠 左 且 靠 右 对 齐 
tv message.gravity = Gravity.LEFT or Gravity.BOTTOM 
// 指 定 文本 视图 的 显示 行 数 为 8 行 
tv _message.setLines (8) 
// 指 定 文本 视图 的 最 大 行 数 为 8 行 
tv message.maxLines = 8 
// 指 定 文本 视图 内 部 文本 的 移动 方式 为 滚动 
tv_message.movementMethod = ScrollingMovementMethod () 
btn start message.setOnClickListener { 
if (!bPlay) { 
bPlay = true 
// 线 程 第 一 种 写法 的 调用 方式 通过 具体 的 线程 类 进行 构造 
// 注 意 每 个 线程 实例 只 能 启动 一 次 ， 不 能 重复 启动 
// 若 要 多 次 执行 该 线程 的 任务 ， 则 需 每 次 都 构造 新 的 线程 实例 
//PlayThread() .start () 
// 线 程 的 第 二 种 写法 ， 采 用 匿名 实例 的 形式 。 第 二 种 写法 无 须 显 式 构造 
Thread { 
// 发 送 “ 开 始 播 放 新 闻 ” 的 消息 类 型 
handler.sendEmptyMessage (BEGIN) 
while (bPlay) { 
// 休 眼 两 秒 ， 模 拟 获 取 突 发 新 闻 的 网 络 延迟 
Thread.sleep (2000) 
// 调 用 Message 的 obtain 方 法， 获得 一 个 消息 实例 
val message = Message.obtain() 
message.what = SCROLL 
message.obj = news[ (Math.random() * 30 % 5).toInt()] 
// 发 送 “ 持 续 滚动 新 闻 ”的 消息 类 型 
handler.sendMessage (message) 
} 
bPlay = true 
Thread.sleep (2000) 
// 发 送 “ 结 束 播放 新 闻 ” 的 消息 类 型 
handler .sendEmptyMessage (END) 
bPlay = false 
}.start () 
1 
} 
btn_stop message.setOnClickListener { bPlay = false } 
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// 线 程 的 第 一 种 写法 ， 继 承 Thread 类 并 重 载 run 方法 


Private inner class PlayThread : Thread() { 


override fun run() { 


handler.sendEmptyMessage (BEGIN) 
while (bPlay) { 
Thread.sleep (2000) 
Val message = Message.obtain() 
message.what = SCROLL 
message.obj = news[ (Math.random() * 30 % 5).toInt()] 
handler.sendMessage (message) 


} 
bPlay = true 
Thread.sleep (2000) 


handler .sendEmptyMessage (END) 
bPlay = false 


// 自 定义 的 处 理 器 类 ， 区 分 三 种 消息 类 型 ， 给 tv_message 显示 不 同 的 文本 内 容 


Private val handler = object : Handler() { 


override fun handleMessage (msg: Message) { 


val desc = tv message.text.toString() 


tv message.text = when (msg.what) { 


BEGIN -> "$desc\n${DateUtil .nowTime} 下 面 开始 播放 新 闻 " 
SCROLL -> "$desc\n$ {DateUtil.nowTime} ${msg.obj}" 
else -> "$desc\n${DateUtil.nowTime} 新 闻 播放 结束 ， 谢 谢 观 看 " 


上 述 滚动 播报 新 闻 的 运行 效果 如 图 10-1 和 图 10-2 所 示 ， 其 中 图 10-1 展示 正在 播放 新 闻 的 界 
上 对 分 线程 每 隔 两 秒 添加 一 条 新 闻 ; 图 10-2 展示 新 闻 播 放 结束 时 的 界面 ， 此 时 主线 程 收 到 分 
END 消息 


面 ， 此 日 


线程 的 





11:01:50 美 








， 于 是 提示 用 户 “ 新 闻 播 放 结束 ， 谢 谢 观 看 ”。 





开始 播放 新 闻 停止 播放 新 闻 开始 播放 新 闻 停止 播放 新 闻 


11:01;40 下 面 开始 播放 新 闻 11:02:20 马克 龙 呼吁 重建 可 与 中 国 匹 敌 的 强大 欧洲 
11:01:42 美国 财 城 拉 斯 维 加 斯 发 生 重大 枪击 事件 11:02:22 日 本 在 越南 承建 的 跨 海 大 桥 未 建 完 已 下 沉 
11:01:44 日 本 在 越南 承建 的 跨 海 大 桥 未 建 完 已 下 沉 11:02:24 北斗 三 号 卫星 发 射 成 功 ， 定位 精度 媳 美 GPS 
11:01:46 美国 赌 城 拉 斯 维 加 斯 发 生 重大 枪击 事件 11:02:26 南水北调 功 在 当代 ， 数 亿 人 喝 上 长 江水 
11:01:48 北斗 三 号 卫星 发 射 成 功 ,定位 精度 妨 美 GPS 11:02:28 美国 赌 城 拉 斯 维 加 斯 发 生 重大 枪击 事件 


11:01:52 北斗 三 号 卫星 发 射 成 功 ， 定 位 精度 媳 美 GPS 11:02:32 新 闻 播放 结束 ， 谢 谢 观看 





10-1 





正在 播放 新 闻 的 界面 图 10-2 新 闻 播放 结束 的 界面 
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10.1.2 ”进度 对 话 框 ProgressDialog 


手机 App 访问 接口 、 加 载 网 页 之 类 的 请 求 服务 端 行为 基本 上 属于 耗 时 操作 ， 慢 的 时 候 要 过 好 
几 秒 才能 加 载 完 毕 。 在 此 期 间 ， 为 了 减少 用 户 的 等 待 焦灼 感 ， 界 面 需 要 展示 正在 加 载 的 动画 ,一 方 
面 避免 产生 App 卡 死 的 错觉 ， 另 一 方面 提示 用 户 耐 心 等 待 。 这 时 候 就 用 到 了 进度 对 话 框 ， 通 过 让 
App 在 加 载 开始 前 弹出 进度 框 ， 加 载 结束 后 关闭 进度 框 ， 从 而 改善 加 载 交 互 的 用 户 体验 。 
进度 对 话 框 分 两 种 , 一 种 是 水 平 进度 对 话 框 , 另 一 种 是 圆圈 进度 对 话 框 。 虽然 在 第 9 章 的 “9.2.2 
进度 条 ProgressBar” 提 到 了 进度 条 控件 ， 但 是 ProgressBar 只 是 一 个 单独 的 控件 ， 必 须 在 页 面 上 占 
好 位 置 才 会 显示 。 而 ProgressDialog 把 ProgressBar 封装 到 了 对 话 框 里 面 ， 有 需要 提示 的 时 候 才 弹 
窗 ， 没 需要 了 就 关闭 窗口 ， 所 以 进度 对 话 框 比 进度 条 更 适用 于 等 待 行为 。 下 面 对 这 两 种 进度 对 话 框 
分 别 进行 介绍 。 
1. 水 平 进度 对 话 杠 
水 平 进度 对 话 框 允许 实时 刷新 当前 进度 ， 方 便 用 户 知晓 已 处 理 的 进展 百分比 。 它 主要 包含 消 
息 标 题 、 消 息 内 容 、 对 话 框 样式 (水 平 还 是 圆圈 ) 、 当 前 进度 这 4 种 元 素 ， 若 使 用 Java 代码 实现 
该 对 话 框 ， 则 是 很 常规 的 编码 风格 ， 具 体 的 Java 代码 举例 如 下 : 
ProgressDialog dialog = new ProgressDialog (this); 
dialog.setTitle ("请 稍 候 ") ; 
dialog.setMessage ("正在 努力 加 载 页 面 "); 
dialog.setMax (100); 


dialog.setProgressStyle (ProgressDialog.STYLE HORIZONTAL); 
dialog.show(); 


水 平 进度 对 话 框 的 Java 编码 看 起 来 中 规 中 矩 ， 可 是 仍然 显得 拖泥带水 ， 很 简单 的 功能 也 花费 
了 6 行 Java 代码 。 倘 若 使 用 Kotlin 书写 ， 则 借助 于 Anko 库 只 需 下 面 两 行 代码 : 


val dialog = progressDialog ("正在 努力 加 载 页 面 "，" 请 稍 候 ") 
dialog.show() 


瞧 瞧 ， 水 平 进度 对 话 框 的 实现 代码 顿时 变 得 清爽 了 许多 ， 其 界面 效果 与 Java 是 完全 一 样 的 。 
当然 ， 因 为 用 到 了 Anko 库 的 扩展 函数 ， 所 以 务必 在 代码 头 部 加 入 一 行 导入 语句 : 
import org.jetbrains.anko.progressDialog 
另外 ， 要 修改 模块 的 build.gradle， 在 dependencies 节点 中 补充 下 述 的 anko-common 包 编 译 配置 : 
compile "org.jetbrains.anko:anko-common: $anko_version" 
在 水 平 进度 对 话 框 弹出 之 后 ， 若 想 更 新 水 平 条 的 进度 值 ， 则 可 调用 以 下 一 行 Kotlin 代码 设置 
当前 进度 : 
dialog.progress = 10 // 进 度 值 ( 取 值 为 0 一 100) 
当 进 度 值 达到 100 时 ， 意 味 着 耗 时 任务 处 理 完成 ， 此 时 即 可 调用 对 话 框 对象 的 dismiss 方法 来 
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下 面 展示 水 平 进度 对 话 框 的 进度 变化 效果 ， 有 具体 如 图 10-3 和 图 10-4 所 示 ， 其 中 图 10-3 表示 
当前 处 理 进 度 为 20%， 图 10-4 表示 当前 处 理 进 度 已 经 到 了 70%。 


请 稍 候 请 稍 候 





正在 努力 加 载 页 面 正在 努力 加 载 页 面 


20/100 70/100 





图 10-3 水平 进 度 对 话 框 的 进度 为 20% 图 10-4 水平 进 度 对 话 框 的 进度 为 70% 
2. 圆圈 进度 对 话 杠 
圆圈 进度 对 话 框 仅 仅 展示 转圈 的 动画 效果 ， 它 不 支持 实时 刷新 处 理 进度 ， 自 然 在 编码 上 比 水 
平 对 话 框 会 简化 一 些 。 可 是 用 Java 编码 显示 圆圈 进度 对 话 框 依旧 需要 下 列 5 行 代码 : 
ProgressDialog dialog = new ProgressDialog (this); 
dialog.setTitle(" 请 稍 候 ") ; 
dialog.setMessage (" 正 在 努力 加 载 页 面 ") ; 
dialog.setProgressStyle (ProgressDialog.STYLE SPINNER); 
dialog.show(); 
要 是 用 Kotlin 实现 该 对 话 框 ， 有 了 水 平 进度 对 话 框 的 的 先例 ， 不 出 意料 只 需 以 下 两 行 Kotlin 
代码 就 行 了 : 
val dialog = indeterminateProgressDialog ("正在 努力 加 载 页面 "， "请 稍 候 ") 
dialog.show() 
注意 到 上 面 的 Kotlin 函数 采取 了 前 级 indeterminate， 该 单词 的 意思 是 “模糊 的 、 不 定 的 ”， 表 
示 这 种 对 话 框 的 处 理 进度 是 不 确定 的 , 不 像 水 平 进度 对 话 框 可 以 明确 指定 当前 进度 , 据 此 开发 者 能 
够 将 progressDialog 与 indeterminateProgressDialog 两 个 函数 区 分 开 。 由 于 该 函数 同样 来 自 于 Anko 
库 ， 因 此 不 要 忘 了 在 用 到 的 代码 文件 头 部 加 入 下 面 这 行 语句 : 
import org.jetbrains.anko.indeterminateProgressDialog 
另外 ， 要 修改 模块 的 build.gradle， 在 dependencies 节点 中 补充 下 述 的 anko-common 包 编 译 配 置 : 


compile "org.jetbrains.anko:anko-common: $anko_version" 


由 Kotlin 代码 实现 的 圆圈 进度 对 话 框 的 转圈 效果 等 同 于 Java 代码 实现 的 效果 ， 具 体 的 转圈 对 
话 框 界面 如 图 10-5 所 示 。 
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正在 努力 加 载 页 面 





10-5 ”圆圈 进度 对 话 框 的 显示 效果 


10.1.3 “异步 任务 doAsync 和 doAsyncResult 


通过 线程 加 上 处 理 器 固然 可 以 实现 滚动 播放 的 功能 ， 可 是 想必 读者 也 看 到 了 ， 这 种 交互 方式 
依旧 很 突 几 ， 还 有 好 几 个 难以 克服 的 缺点 : 


(1) 自 定义 的 处 理 器 仍然 存在 类 继承 和 函数 重 载 的 元 余 写法 。 
(2) 每 次 操作 界面 都 得 经 过 发 送 消息 、 接 收 消息 两 道 工序 ， 烦 琐 且 拖 省 。 
(3) 线程 对 象 和 处 理 器 对 象 均 需 在 指定 的 Activity 代码 中 声明 ， 无 法 在 别处 重用 。 
鉴于 此 ，Android 早已 提供 了 异步 任务 AsyncTask 这 个 模板 类 ， 专 门 用 于 耗 时 任务 的 分 线程 处 
理 。 然 而 AsyncTask 的 用 法 着 实 不 简单 ， 首 先 它 是 个 模板 类 ， 初 学 者 县 着 模板 就 发 慌 ; 其 次 它 区 分 
了 好 几 种 运行 状态 ， 包括 未 运行 、 正 在 运行 、 取 消 运行 、 运 行 结束 等 ， 一 堆 概 念 令 人 头痛 ， 再 次 为 
了 各 种 状况 都 能 与 界面 交互 ， 又 得 定义 事件 监听 器 及 其 事件 处 理 方法 ; 末了 还 得 在 Activity 代码 中 
实现 监听 器 的 相应 方法 ， 才 能 正常 调用 定义 好 的 AsyncTask 类 。 
初步 看 了 一 下 自 定义 AsyncTask 要 做 的 事情 ， 直 让 人 倒 吸 一 口 冷气 ， 看 起 来 很 高 深 的 样子 ， 
确实 每 个 Android 开发 者 刚 接触 AsyncTask 时 都 费 了 不 少 脑 细胞 。 为 了 说 明 AsyncTask 是 多 么 的 与 
众 不 同 ， 下 面 给 出 异步 加 载 书籍 任务 的 完整 Java 代码 ， 温 习 一 下 那些 年 虐 过 开发 者 的 AsyncTask: 
// 模 板 类 的 第 一 个 参数 表示 外 部 调用 execute 方法 的 输入 参数 类 型 ， 第 二 个 参数 表示 运行 过 程 中 与 界 
面 交 互 的 数据 类 型 ， 第 三 个 参数 表示 运行 结束 后 返回 的 输出 参数 类 型 
Public class ProgressAsyncTask extends AsyncTask<String, Integer, String> { 
Private String mBook; 
// 构 造 函 数 ， 初 始 化 数据 
Public ProgressAsyncTask (String title) { 
super (); 
mBook = title; 





i 


// 在 后 台 运 行 的 任务 代码 ， 注 意 此 处 不 可 与 界面 交互 

@Override 

Protected String doInBackground(String... params) { 
int ratio = 0; 
for (; ratio <= 100; ratio += 5) { 


// 睡眠 200 毫秒 模拟 网 络 通信 处 理 
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try { 
Thread.sleep (200); 
} catch (InterruptedException e) { 
e.PrintStackTrace() 7 
上 
// 刷 新 进度 ， 该 函数 会 触发 调用 onProgressUpdate 方法 
PublishProgress (ratio) 7 


return params [0]7 


// 在 任务 开始 前 调用 ， 即 先 于 doInBackground 执行 

@Override 

protected void onPreExecute() { 
mListener.onBegin (mBook); 


// 刷 新 进度 时 调用 ， 由 publishProgress 函数 触发 

@Override 

Protected void onProgressUpdate (Integer... values) { 
mListener.onUpdate (mBook, values[0], 0); 


// 在 任务 结束 后 调用 ， 即 后 于 doInBackground 执行 

@Override 

protected void onPostExecute (String result) { 
mListener.onFinish(result); 


// 在 任务 取消 时 调用 

@Override 

protected void onCancelled(String result) { 
mListener.onCancel (result); 


// 声 明 监 听 器 对 象 

Private OnProgressListener mListener; 

Public void setOnProgressListener (OnProgressListener listener) { 
mListener = listener; 


// 定 义 该 任务 的 事件 监听 器 及 其 事件 处 理 方法 

Public static interface OnProgressListener { 
Public abstract void onFinish(String result); 
Public abstract void onCancel (String result) 7 
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public abstract void onUpdate (String request, int progress, int 
sub Progress) 
Public abstract void onBegin (String request) 


， 
上 


瞧 瞧 上 面 异 步 线 程 处 理 的 Java 代码 ， 复 杂 的 交互 过 程 能 叫 初 学 者 落荒 而 逃 。 见 识 过 了 
AsyncTask 的 惊涛骇浪 , 不 禁 别 叹 开发 者 的 心灵 有 多 么 的 强大 。 多 线程 任务 是 如 此 的 令 人 望而却步 ， 
直到 Kotlin 与 Anko 的 搭档 出 现 , 因为 它 俩 在 线程 方面 带 来 了 革命 性 的 思维 , 即 编程 理应 面向 产品 ， 
而 非 面 向 机 器 。 对 于 分 线程 与 界面 之 间 的 交互 问题 ， 它 俩 双 剑 合 壁 ， 给 出 了 堪 称 完美 的 解决 方案 ， 
所 有 的 线程 处 理 逻 辑 都 被 归结 为 两 点 : 其 一 是 如 何 标识 这 种 牵涉 界面 交互 的 分 线程 ， 该 点 由 关键 字 

“doAsync” 阅 明 ; 其 二 是 如 何在 分 线程 中 传递 消息 给 主线 程 ， 该 点 由 关键 字 “uiThread” 界 定 。 
有 了 这 两 个 关键 字 ， 分 线程 的 编码 变 得 异乎 寻常 的 简单 , 即使 加 上 Activity 的 响应 动作 也 只 
以 下 密 容 数 行 Kotlin 代码 : 
Private lateinit var dialog: ProgressDialog 
// 展 示 在 圆圈 进度 对 话 框 
Private fun dialogCircle(book: String) { 
dialog = indeterminateProgressDialog("${book} 页 面 加 载 中 …… | 
doAsync { 
// 睡眠 200 毫秒 模拟 网 络 通信 处 理 
for (ratio in 0..20) Thread.sleep (200) 
// 处 理 完成 ， 回 到 主线 程 在 界面 上 显示 书籍 加 载 结果 
uiThread { finishLoad (book) } 


Private fun finishLoad (book: String) { 
tv_async.text = "您 要 阅读 的 《$book》 已 经 加 载 完毕 " 
// 如 果 进度 对 话 框 还 在 显示 ， 就 关闭 进度 对 话 框 
if (dialog.isShowing) dialog.dismiss() 

} 

以 上 Kotlin 代码 被 doAsync 身后 大 括号 括 起 来 的 代码 段 就 是 分 线程 要 执行 的 全 部 代码 ;至 于 
uiThread 身后 大 括号 括 起 来 的 代码 ， 则 为 通知 主线 程 要 完成 的 工作 。 倘 若 在 分 线程 运行 过 程 中 要 不 
断 刷新 当前 进度 ， 也 只 需 在 待 刷新 的 地 方 添加 一 行 viThread 代码 便 成 。 

下 面 是 添加 了 进度 刷新 功能 的 Kotlin 代码 例子 : 

// 展 示 在 长 条 进度 对 话 框 
Private fun dialogBar (book: String) { 
dialog = progressDialog ("${book} 页 面 加 载 中 …… mn 和 等 要 
doasync { 
or (ratio Ln D020 


Thread.sleep (200) 
// 处 理 过 程 中 ， 实 时 通知 主线 程 当前 的 处 理 进度 
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uiThread { dialog.progress = ratio*100/20 } 
} 
uiThread { finishLoad(book) } 


上 
有 些 时 候 ，App 会 启动 多 个 分 线程 ， 然 后 在 代码 中 对 这 些 线程 对 象 进行 调度 ， 从 而 动态 控制 
每 个 线程 的 运行 状态 。 此 时 ，doAsync 的 另 一 个 兄弟 doAsyncResult 就 派 上 用 场 了 ， 顾 名 思 义 
doAsyncResult 允许 返回 结果 ， 这 个 结果 便 是 一 个 异步 线程 对 象 ， 通 过 调用 线程 对 象 的 各 种 查询 和 
控制 方法 ， 即 可 实现 人 为 干预 线程 运行 的 功能 。 
下 面 是 使 用 doAsyncResult 方法 的 Kotlin 示例 代码 : 
/ /展示 在 进度 条 ProgressBar 
Private fun progressBar(book: String) { 
// 构 造 异步 处 理 需要 执行 的 代码 段 longTask， 返 回 字 符 串 类 型 
val longTask: (AnkoAsyncContext<Context>.() -> String) = { 


for (ratio in 0..20) Thread.sleep (200) 
"加 载 好 了 " // 这 是 longTask 处 理 完成 的 返回 结果 





} 
//doAsyncResult 返回 一 个 异步 线程 对 象 
val future : Future<String> = doAsyncResult (null, longTask) 
for (count in 0..10) { 
if (future.isDone) { 
//isDone 是 否 完成 ，iscancelled 是 否 取 消 ，get 获取 处 理 结果 
tv_async.text = "您 要 阅读 的 《$ {book}》 已 经 S${future.get ()}" 
Pb_async.progress = 100 
break 
} 
Pb_async.progress = count*100/10 
Thread.sleep (1000) 


. 


不 过 因为 doAsyncResult 方法 需要 由 开发 者 自行 判断 分 线程 是 否 处 理 完 成 , 造成 处 理 简单 事务 
时 反而 显得 更 加 麻烦 ， 所 以 除了 少数 高 级 场合 之 外 ， 一 般 并 不 直接 调用 该 方法 。 














10.2 访问 HTTP 接口 


网 络 编程 存在 着 多 种 通信 协议 ,常见 的 有 传输 层 的 TCP 和 UDP 协议 ,还 有 应 用 层 的 诸多 协议 ， 
包括 用 于 数据 与 文件 交互 的 HTTP 协议 和 FTP 协议 、 用 于 邮件 收发 的 SMTP 协议 和 POP3 协议 、 
用 于 即时 通信 的 XMPP 协议 和 MQTT 协议 等 ,在 这 些 众多 的 网 络 通信 协议 中 , 最 常用 的 当 数 HTTP 
协议 ， 它 不 但 适用 于 客户 端 与 服务 端 之 间 的 接口 调用 ， 也 适用 于 客户 端 与 服务 端 之 间 的 文件 传输 。 
那么 Kotlin 又 是 如 何 实现 HTTP 协议 的 编程 运用 呢 ? 本 节 接 下 来 将 从 HTTP 交互 的 数据 格式 .HTTP 
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接口 的 调用 方式 、HTTP 图 片 的 获取 方式 这 几 个 方面 详细 阐述 Kotlin 给 HTTP 编程 带 来 的 脱胎 换 骨 
的 变化 。 


10.2 


.1 移动 数据 格式 JSON 


JSON 是 App 进行 网 络 通信 时 最 常见 的 数据 交互 格式 ，Android 也 自 带 了 JSON 格式 的 处 理工 
具 包 orgjson， 该 工具 包 主要 提供 JSONObject (JSON 对 象 ) 与 JSONArray (JSON 数组 ) 的 解析 


处 理 。 


1 


下 面 分 别 介绍 这 两 种 工具 类 的 用 法 。 


. JSONObject 


JSONObject 的 常用 方法 说 明 如 下 。 


Se 


2 


构造 函数 : 从 指定 字符 囊 构造 出 一 个 JSONObject 对 象 。 
getJSONObject: 获取 指定 名 称 的 JSONObject 对 象 。 
getString: 获取 指定 名 称 的 字符 串 。 

getInt: 获取 指定 名 称 的 整 型 数 。 

getDouble: 获取 指定 名 称 的 双 精 度数 。 

getBoolean: 获取 指定 名 称 的 布尔 数 。 

geUSONArray: 获取 指定 名 称 的 JSONArray 数组 对 象 。 
put: 添加 一 个 JSONObject 对 象 。 

toString: 把 当前 JSONObject 输出 为 一 个 JSON 字符 串 。 


. JSONArray 


JSONArray 的 常用 方法 说 明 如 下 。 


length: 获取 JSONArray 数组 对 象 的 长 度 。 
getJSONObject: 获取 JSONArray 数组 对 象 在 指定 位 置 处 的 JSONObject 对 象 。 
put: 往 JSONArray 数组 对 象 中 添加 一 个 JSONObject 对 象 。 


使 用 JSONObject 和 JSONArray 对 JSON 串 进 行 手工 解析 ， 处 理 过程 比 较 常规 ， 完 成 该 功能 的 


Kotlin 
JSON 


代码 与 Java 代码 大 同 小 异 。 下 面 直接 给 出 Kotlin 解析 JSON 串 的 代码 片段 ， 包 括 如 何 构造 
串 、 如 何 解 析 JSON 串 以 及 如 何 遍 历 JSON 串 : 


// 构 造 json 串 
Private val jsonStr: String 
get() { 
val obj = JSONObject () 
obj .put ("name"， "地址 信息 ") 
val array = JSONArray () 
Eor (i dn O02 二 
val item = JSONObject () 
item.put ("item"，" 第 ${i+1} 个 元 素 ") 
array.put (item) 
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obj.put ("list", array) 
obj.put("count", array.length()) 
obj .put ("desc"，" 这 是 测试 串 ") 
return obj .toString() 


// 解 析 json 串 
Private fun ParserJson (jsonStr: String?): String { 
val obj = JSONObject (jsonStr) 

Var result = "name=$fobj.getString("name") }\n" + 
"desc=${obj.getstring("desc")}\n" + 
"count=${obj .getInt ("count")}\n" 

val listArray = obj.getJSONArray ("list") 

//util 表示 的 范围 是 左 闭 右 开 区 间 。 以 下 语句 相当 于 for (i in0..listArray.length() 

= 

for (i in 0 until listArray.length()) { 

val item = listArray.getJSONObject (i) 


result = "${result}\titem=${item.getString ("item")}\n" 
} 
return result 
} 
// 遍 历 json 串 


Private fun traverseJson (jsonStr: String?): String { 
Var result = "" 
val obj = JSONObject (jsonStr) 
val it = obj.keys() 
while (让 .hasNext()) { // 遍历 JSONObject 
Var key = 让 .next() .toString() 
result = "${result}key=$key, value=$ {obj.getString(key)}\n" 
} 
return result 


上 述 处 理 JSON 串 的 Kotlin 代码 对 应 的 界面 效果 如 图 10-6 一 图 10-8 所 示 , 其 中 图 10-6 所 示 为 
构造 JSON 串 的 结果 界面 ， 图 10-7 所 示 为 解析 JSON 串 的 结果 界面 ， 图 10-8 所 示 为 遍历 JSON 串 
的 结果 界面 。 








构造 JSON 串 解析 JSON 审 遍历 JSON 利 构造 JSON 曲 解析 JSON 审 遍历 JSON 审 构造 JSON 哩 解析 JSON 审 遍历 JSON 趾 


《count"3,isf"ICitem" 第 1 个 元 素 "),{item" 第 2 个 元 


key=count, value=3 
素 )《item"- 第 3 个 元 素 ?j'desc 这 是 测试 串 "name': 地 址 信 
息 } 


list, value=[fitem" 第 1 个 元 素 ]fiem' 第 2 个 元 
素 fitem": 第 3 个 元 素 〗] 

key=name value= 地 址 信息 
key=desc,value= 这 是 测试 串 





个 元 : 
iem= 第 3 个 元 素 





图 10-6 构造 json 串 的 结果 图 10-7 解析 json 串 的 结果 10-8 ”遍历 json 串 的 结果 
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10.2.2 ”JSON 串 转 数 据 类 


10.2.1 小 节 提 到 Kotlin 对 JSON 串 的 手工 解析 没有 什么 好 办 法 ,其实 有 更 高 层次 的 办 法 。 手 工 
解析 JSON 串 实在 是 麻烦 ， 费 时 费力 还 容易 犯错 ， 所 以 好 汉 不 吃 眼前 亏 ， 此 路 难 走 不 如 另 寻 捷 径 ， 
捷径 便 是 甩 开 手工 解析 几 条 街 的 自动 解析 。 

既然 是 自动 解析 , 首先 要 制定 一 个 规则 , 约定 JSON 串 有 哪些 元 素 , 具体 对 应 怎样 的 数据 结构 ; 
其 次 还 得 有 个 自动 解析 的 工具 ， 俗 话说 得 好 ，“ 没 有 金刚 钻 ， 不 挠 瓷器 活 ”。 对 于 捷径 第 一 要 素 的 
JSON 数据 结构 定义 ，Kotlin 特有 的 数据 类 正好 派 上 用 场 ， 字 段 名 、 字 段 类 型 、 字 段 默认 值 等 色香 
味 俱全 ， 还 有 自 带 方法 equals、copy、toString 等 下 酒 小 菜 ， 只 要 开发 者 轻 拉 珠 帘 便 是 一 大 桌 的 满 
汉 全 席 。 到 底 有 多 么 省 事 ， 且 看 下 面 的 用 户 信息 数据 类 ， 包 括 姓名 、 年 龄 、 身 高 、 体 重 、 婚 否 等 字 
段 的 定义 以 及 存 取 操 作 在 内 的 完整 功能 ， 仅 需 一 行 Kotlin 代码 就 全 部 搞定 了 : 








data class UserInfo (Var name: String="", var age: Int=0, var height: Long=0L, 
Var weight: Float=0F, var married: Boolean=false) 


接着 解决 捷径 第 二 要 素 的 工具 使 用 ，JSON 解析 除了 系统 自 带 的 orgjson 外 ， 谷 歌 公 司 也 提供 了 
一 个 增强 库 Gson， 专 门 用 于 JSON 串 的 自动 解析 。 不 过 由 于 是 第 三 方 库 ， 因 此 首先 要 修改 模块 的 
build.gradle 文件 ， 在 里 面 的 dependencies 节点 下 添加 下 面 一 行 配置 ， 表 示 导 入 指定 版 本 的 Gson 库 : 

compile "com.google.code.gson:gson:2.8.2" 

其 次 ， 还 要 在 kt 源码 文件 头 部 添加 如 下 一 行 导 入 语句 ， 表 示 后 面 会 用 到 Gson 工具 类 : 

import com.google.gson.Gson 

完成 了 以 上 两 个 步骤 ， 然 后 就 能 在 代码 中 调用 Gson 的 各 种 处 理 方法 了 ，Gson 常用 的 方法 有 
两 个 ， 一 个 名 叫 toJson， 可 把 数据 对 象 转换 为 JSON 字符 串 ， 另 一 个 名 叫 fomJson， 可 将 JSON 字 
符 串 自动 解析 为 数据 对 象 , 该 方法 的 代码 调用 格式 为 “fromJson(json 串 ， 数 据 类 的 类 名 ::classjava)”。 
Kotlin 的 数据 类 定义 代码 尚且 只 有 一 行 ， 这 里 的 JSON 串 自动 解析 仍旧 只 需 一 行 代码 ， 为 开发 者 节 
省 了 不 少时 间 。 

下 面 是 个 通过 Gson 库 实 现 JSON 自动 解析 的 Kotlin 代码 例子 : 

class JsonConvertActivity : AppCompatActivity() { 

Private val user = UserInfo (name=" 阿 四 ", age=25, height=160L, weight=45.0f, 
married=false) 


// 把 数据 类 的 对 象 直接 转换 成 json 格式 


Private val json = Gson() .toJson (user) 





override fun onCreate (savedInstanceState: Bundle?) { 
Super .onCreate (savedInstanceState) 
setContentView(R.layout .activity json convert) 
btn origin json.setOnClickListener { tv json.text = "json 串 内 容 如 下 : 
\n$json" } 
btn convert json.setOnClickListener { 


// 利 用 Gson 包 直 接 将 json 串 解 析 为 对 应 格式 的 数据 类 对 象 
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val newUser = Gson() .fromJson (json，UserInfo::class.java) 
tv_json.text = "从 json 串 解 析 而 来 的 用 户 信息 如 下 : " + 

"\n\t 姓名 =$ {newUser.name}" + 

"\n\t 年 龄 =$ {newUser.age}" + 

"\n\t 身高 =$ {newUser.height}" + 

"\n\t 体重 =$ {newUser.weight}" + 

"\n\t 婚 否 =$ {newUser .married}" 


} 


上 述 JSON 串 自 动 解析 前 后 的 效果 分 别 如 图 10-9 和 图 10-10 所 示 ， 其 中 图 10-9 展示 待 解析 的 
JSON 字符 串 内 容 ， 图 10-10 展示 按照 数据 类 格式 自动 解析 之 后 的 各 字段 值 。 


network network 


原始 JSON 串 转换 JSON 串 原始 JSON 串 转换 JSON 串 


json 串 内 容 如 下 : 从 json 串 解析 而 来 的 用 户 信息 如 下 : 
{"age":25,"height": 姓名 = 阿 四 


160,"married":false,"name":" 阿 年 龄 =25 

四 ""weight":45.0} 身高 =160 
体重 =45.0 
婚 否 =false 


图 10-9 自动 解析 前 的 JSON 字符 串 图 10-10 自动 解析 后 的 数据 类 字段 





10.2.3 HTTP 接口 调用 


手机 上 的 图 文 资源 毕竟 有 限 ， 为 了 获取 更 丰富 的 信息 ， 就 得 到 辽阔 的 互联 网 大 海上 冲浪 。App 
自身 也 要 经 常 与 服务 器 交互 ， 以 便 获 取 最 新 的 数据 显示 到 界面 上 。 这 个 客户 端 与 服务 端 之 间 的 信息 
交互 功能 基本 使 用 HTTP 协议 进行 通信 , 即 App 访问 服务 器 的 HTTP 接口 来 传输 数据 。HTTP 接口 
调用 在 Java 代码 中 可 不 是 一 个 轻松 的 活 ， 开 发 者 若 用 最 基础 的 HttpURLConnection 来 编码 ， 则 至 
少 要 考虑 以 下 场景 的 处 理 : 


(1) HTTP 的 请 求 方式 是 什么 ， 是 GET、POST、PUT 还 是 DELETE? 
(2) HTTP 的 连接 超时 时 间 是 多 少 ， 请 求 应 答 的 超时 时 间 又 是 多 少 ? 
(3) HTTP 头 部 的 语言 和 浏览 器 信息 该 怎么 设置 ? 

(4) HTTP 传输 的 数据 内 容 采 取 的 是 哪 种 编码 方式 ? 

(5) HTTP 的 应 答 数 据 如 果 是 压缩 过 的 ， 又 要 如 何 解压 ? 

(6) HTTP 的 输入 输出 流 需要 注意 哪些 方面 ? 

(7) HTTP 如 何 分 块 传输 较 大 的 数据 信息 ? 


瞧 瞧 上 面 层 出 不 穷 的 功能 要 求 ， 如 果 开发 者 事 必 射 亲 逐 个 编码 ， 那 可 真是 要 累 得 够 哗 。 因 此 ， 
各 种 意图 取代 HttpURLConnection 的 网 络 交互 框架 如 雨后春笋 般 涌 现 出 来 ， 既 有 老 资 格 的 如 
HttpClient， 又 有 后 起 之 秀 如 Android-Async-Http、Volley、OkHttp、Retrofit 等 ， 可 谓 是 百花 齐 放 、 
百家争鸣 。 当 然 ， 这 些 网 络 框架 是 需要 学 习 成 本 的 ， 使 用 起 来 也 不 如 想象 中 的 那么 容易 ， 它 们 只 是 
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在 技术 上 各 有 千秋 ， 并 非 终 极 的 解决 方案 ， 往 往 是 你 方 唱 罢 我 登台 ， 各 领 风 骚 几 年 然后 歇 菜 。 

其 实 ，HTTP 交互 原本 无 须 这 样 大 动 干戈 ， 常 见 的 接口 调用 仅仅 是 App 往 服务 器 发 送 一 串 请 
求 信息 ， 然 后 服务 器 返回 给 App 一 串 处 理 结果 ， 这 种 简单 的 业务 场景 已 经 足够 应 付 大 多 数 应 用 的 
网 络 通信 需求 。 所 以 大 道 至 简 ，Kotlin 把 网 络 交互 看 作 是 跟 文 件 读 写 一 样 的 IO 操作 ， 后 端的 服务 
地 址 就 像 是 一 个 文件 路 径 ， 于 是 请 求 服务 器 的 数据 犹如 读 取 文 件 内 容 。 同 时 , 文本 分 为 文本 文件 和 
二 进 制 文 件 两 种 , 则 HTTP 接口 对 应 获取 文本 数据 和 获取 二 进 制 数据 两 种 方式 , 于 是 整个 网 络 请 求 
便 简 化 为 网 络 数据 的 保存 跟 读 取 了 。 

具体 到 详细 的 Kotlin 编码 ,既然 文件 对 象 由 “File( 文 件 路 径 )” 构 建 , 那么 地 址 对 象 就 由 “URL 
(网 络 地 址 ) ”构建 。 获 取 接 口 数据 则 有 readText 和 readBytes 两 种 方法 ， 前 者 用 于 获取 文本 形式 
的 应 答 数据 ， 后 者 用 于 获取 二 进 制 形式 的 应 答 数据 ， 如 图 片 文件 、 音 频 文件 等 。 仅 仅 一 个 readText 
方法 真 的 能 完成 繁杂 的 HTTP 接口 调用 操作 吗 ? 下 面 通过 一 个 具体 的 接口 访问 案例 探讨 一 下 如 何 
使 用 Kotlin 代码 实现 HTTP 接口 调用 。 

智能 手机 普遍 提供 了 定位 功能 ， 可 是 系统 自 带 的 定位 服务 只 能 获得 用 户 所 在 的 经 纬度 信息 ， 而 
这 些 枯燥 的 经 纬度 数字 令 人 不 知 所 云 ， 肯 定 要 把 经 纬度 转换 为 详细 的 地 址 信息 才 方 便 用 户 理解 。 如 
果 将 经 纬度 转换 为 详细 地 址 ， 就 要 访问 谷歌 地 图 提供 的 地 址 查询 接口 ， 该 接口 的 地 址 形 如 
“http://maps.google.cn/maps/api/geocode/json? 请 求 参 数 信 息 ”,，App 把 经 纬度 数据 作为 请 求 参 数 传 入 ， 
对 方 会 返回 一 个 包含 地 址 信息 的 JSON 串 ， 通 过 解析 JSON 串 即 可 获得 当前 的 详细 地 址 。 

由 于 访问 网 络 需要 在 分 线程 进行 ， 因 此 接口 调用 代码 必须 放 在 doAsyne 代码 块 中 ， 下 面 给 出 
根据 经 纬度 获取 详细 地 址 的 Kotlin 代码 片段 : 

Private val mapsUrl = "http://maps.google.cn/maps/api/geocode/ 

json?latlng={0}, {1l}&sensor=true&language=zh-CN" 





// 位 置 监听 器 侦 听 到 定位 变化 事件 ， 就 调用 该 函数 请 求 详细 地 址 
Private fun setLocationText (location: Location?) { 
if (location != null) { 
doAsync { 
// 根 据 经 纬度 数据 从 谷歌 地 图 获取 详细 地 址 信息 
val Url = MessageFormat .format (mapsUrl, location.latitude, 
location.longitude) 
val text = URL (url) .readText () 
val obj = JSONObject (text) 
val resultArray = obj.getJSONArray ("results") 
var address = 
// 解 析 json 字符 串 ， 其 中 formatted_address 字段 为 具体 地 址 名 称 
if (resultArray.length() > 0) { 
val resultObj = resultArray.getJSONObject (0) 
address = resultObj.getSstring("formatted address") 
} 
// 获 得 该 地 点 的 详细 地 址 之 后 ， 回 到 主线 程 把 地 址 显示 在 界面 上 


uiThread { findAddress (location, address) } 
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} else { 
tv_location.text = "$mLocation\n 暂 未 获取 到 定位 对 象 " 
} 
. 


// 在 主线 程 中 把 定位 信息 连同 地 址 信息 都 打印 到 界面 上 
Private fun findAddress (location: Location, address: String) { 
tv_location.text = "$mLocation\n 定位 对 象 信息 如 下 : " + 

"\n\t 时 间 : ${DateUtil.nowDateTime}" + 
"\n\t 经 度 : ${1ocation.1longitude}， 纬度 : ${location.latitude}" + 
"\nNt 高 度 : $S{location.altitude} 米 , 精度 : ${location.accuracy} 米 "+ 
"\n\t 地 址 : Saddress" 

} 


涉及 网 络 交 互 的 接口 请 求 操作 需要 事先 声明 该 App 的 互联 网 权限 。 另 外 ， 上 述 例 子 也 要 声明 
定位 权限 ， 即 在 AndroidManifest.xml 中 添加 相应 的 权限 声明 ， 具 体 的 权限 声明 配置 信息 如 下 所 示 : 


<!-- 互联 网 --> 
<uses-permission android:name="android.permission.INTERNET" /> 
<!-- 定位 --> 


<uses-permission android:name="android.permission.ACCESS_ FINE LOCATION" /> 
<uses-permission 
android:name="android.permission.ACCESS _ COARSE LOCATION" /> 


前 述 的 Kotlin 代码 看 起 来 显然 简明 扼要 ,寥寥 数 行 便 搞 
定 了 完整 的 接口 功能 实现 。 如 果 使 用 Java 代码 实现 类 似 功 
能 ， 首 先 HTTP 调用 就 得 提供 底层 的 接口 访问 代码 ， 其 次 分 
线程 请 求 网 络 又 得 专门 写 一 个 继承 自 AsyncTask 的 任务 处 理 | 定位 闫 -9pSi 下 ， 


network 


代码 ， 末 了 Activity 这 边 还 得 实现 该 任务 的 完成 事件 接口 ， | 噶 加 : 2091052333033 癌 讼 ， 
真是 兴 师 动 众 、 劳 民 伤 财 。 由 此 可 见 ，Kotlin 的 网 络 交互 是 | 26;105498333333337 
革命 性 的 ， 方 式 虽然 简单 ， 却 足以 应 付 大 部 分 的 网 络 通信 需 上 : 中国 福 建 省 福州 市 区 楼 区 军 榕 路 邮政 





求 , 并 且 运 行 效果 与 Java 代码 几乎 没有 差别 , 例如 调用 地 图 
接口 查询 地 址 信息 , 无 论 采 用 Java 编码 还 是 Kotlin 编码 , 界 ” 图 10-11 调用 HTTP 接口 根据 经 纬度 
面 效果 都 如 图 10-11 所 示 。 获取 详细 的 地 址 信息 





10.2.4 HTTP 图 片 获取 


10.2.3 小 节 利用 readText 方法 完成 了 文本 数据 的 接口 调用 ， 当 时 提 到 了 readBytes 可 用 于 获取 
二 进 制 数据 (如 图 片 文件 ), 那么 获取 网 络 图 片 是 否 也 同样 方便 呢 ? 下 面 就 继续 探讨 如 何 使 用 Kotlin 
代码 读 取 网 络 图 片 。 

获取 网 络 图 片 的 基本 流程 同文 本 格式 的 接口 访问 一 样 ， 先 通过 URL 类 构建 地 址 对 象 ， 然 后 在 
doAsync 代码 块 中 调用 地 址 对 象 的 readBytes 方法 获得 图 片 的 字 节 数组 .将 字 节 数组 转换 为 位 图 对 象 ， 
这 在 第 8 章 的 “8.3.3 读 写 图 片 文件 ”已 经 介绍 过 了 ， 即 利用 BitmapFactory 工具 的 decodeByteArray 
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方法 实现 转换 操作 。 转 换 好 的 位 图 当然 可 以 在 主线 程 中 直接 显示 出 来 ， 也 可 以 先 保存 为 图 片 文 件 ， 
等 到 需要 的 时 候 再 去 读 取 。 第 8 章 描述 如 何 把 位 图 保存 为 图 片 文件 时 ， 由 于 Bitmap 相关 类 并 未 提供 
简单 的 图 片 保 存 方法 ， 因 此 当时 保存 位 图 文件 还 着 实 费 了 一 番 功 夫 。 现 在 保存 网 络 图 片 反而 无 须 如 
此 折腾 ， 这 是 因为 获取 网 络 图 片 得 到 了 字 节 数组 ， 字 节 数 组 保存 为 文件 可 是 相当 方便 ， 只 要 调用 File 
对 象 的 writeBytes 方法 ， 短 短 一 行 就 保存 好 图 片 了 。 

介绍 完了 网 络 图 片 的 存 取 流 程 ， 最 终 的 Kotlin 编码 一 如 既往 的 简单 明了 。 下 面 是 一 个 动态 显 
示 验 证 码 的 Kotlin 页 面 代 码 例子 : 

class HttpImageActivity : AppCompatActivity() { 


Private val imageUrl = "http://222.77.181.14/ValidateCode.aspx?r=" // 图 
片 验 证 码 的 测试 地 址 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity http image) 
iv image code.setOnClickListener { getImageCode() } 
getImageCode() 

} 


// 获 取 网 络 上 的 图 片 验证 码 
Private fun getImageCode() { 
iv image code.isEnabled = false 
doAsync { 
val Url = "$imageUrl$ {DateUtil.getFormatTime()}" 
// 获 取 指 定 url 返回 的 字 节 数组 
val bytes = URL (ur1l) .readBytes () 
// 把 字 节 数组 解码 为 位 图 数据 
val bitmap = BitmapFactory.decodeByteArray (bytes, 0, bytes.size) 
// 也 可 通过 下 面 三 行 代码 把 字 节 数组 写 入 文件 ， 即 生成 一 个 图 片 文件 
val path = getExternalFilesDir (Environment .DIRECTORY DOWNLOADS). 
,OString()》 4 /nn 
val file path = "$path$ {DateUtil.getFormatTime()}.png" 
File(file path) .writeBytes (bytes) 
// 获 得 验证 码 图 片 数据 ， 回 到 主线 程 把 验证 码 显示 在 界面 上 
uiThread { finishGet (bitmap) } 


. 


// 在 主线 程 中 显示 获得 的 验证 码 图 片 

Private fun finishGet (bitmap: Bitmap) { 
iv image code.setImageBitmap (bitmap) 
iv_image code.isEnabled = true 


} 
看 到 了 吧 ， 即 使 是 完整 的 Activity 页 面 ，Kotlin 也 只 需 数 十 行 代码 而 已 。 倘 若 使 用 Java 完成 同 
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样 的 功能 ， 除 了 HTTP 底层 与 AsyncTask 的 编码 之 外 ， 还 得 补充 Bitmap 对 象 的 图 片 保存 代码 。 也 
就 是 说 ，Java 编程 需要 额外 增加 三 个 工具 类 的 实现 代码 ， 只 这 一 点 ，Kotlin 的 效率 就 令 人 赞叹 。 而 
且 ， 短 小 精 悍 的 Kotlin 代码 并 未 造成 任何 功能 缺失 ， 以 上 面 的 图 片 验证 码 页 面 为 例 ， 使 用 Java 编 
码 和 使 用 Kotlin 编码 最 终 的 显示 效果 都 如 图 10-12 和 图 10-13 所 示 。 其 中 ， 图 10-12 展示 刚 打 开 页 
面 的 初始 验证 码 ， 然 后 点 击 验证 码 图 片 ， 得 到 重新 获取 后 的 最 新 验证 码 ， 如 图 10-13 所 示 。 














点 击 验证 码 即 可 刷新 验证 码 图 片 点 击 验证 码 即 可 刷新 验证 码 图 片 
10-12 ”初始 页 面 上 的 图 片 验证 码 图 10-13 点 击 刷新 后 的 图 片 验证 码 


10.3 ”文件 下 载 操作 


除了 HTTP 接口 调用 这 个 常用 功能 之 外 ， 网 络 通信 还 有 另 一 种 普遍 运用 的 形式 ， 这 便 是 文件 
下 载 操作 。 接 口 调用 只 能 获取 结构 化 的 文本 数据 ,而 内 容 丰 富 、 格 式 各 异 的 流 式 数 据 往 往 需 要 下 载 
之 后 再 进行 处 理 。 待 下 载 的 文件 格式 小 至 图 片 文件 、APK 安装 包 ， 大 至 音乐 文件 、 影 视 文件 ， 可 
以 这 么 说 ， 自 从 有 了 下 载 功 能 ， 手 机 上 的 多 媒体 娱乐 才 如 此 丰富 多 彩 。 本 节 就 从 Android 自 带 的 下 
载 管理 器 DownloadManager 入 手 ， 详 细 论述 App 实现 下 载 相关 功能 的 几 种 方式 ， 以 及 如 何 利用 
Kotlin 完成 文件 下 载 的 编码 。 


10.3.1 下 载 管理 器 DownloadManager 


10.2.4 小 节 提 到 调用 URL 实例 的 readBytes 方法 可 以 获取 小 图 片 ， 可 是 这 么 做 存在 诸多 限制 ， 
比如 : 

(1) 无 法 断 点 续 传 ， 一 旦 中 途 失 败 ， 只 能 从 头 开始 获取 。 

(2) 只 能 转 码 为 图 片 ， 难 以 转 码 成 其 他 文件 。 

(3) 不 是 真正 意义 上 的 下 载 操 作 ， 没 法 设置 下 载 参数 。 

所 以 说 ，“10.2.4 HTTP 图 片 获 取 ” 小 节 的 做 法 只 能 用 于 获取 小 图 ， 如 果 要 下 载 大 图 或 者 其 
他 格式 的 大 文件 ， 就 要 另 想 办 法 。 因 为 下 载 功 能 比较 常用 ， 而 且 业 务 功 能 相对 统一 ， 所 以 Android 
从 2.3 (API 9) 开始 便 提供 了 专门 的 下 载 工具 一 一 DownloadManager， 用 于 统一 管理 下 载 操作 。 

下 载 管理 器 DownloadManager 的 对 象 从 系统 服务 Context.DOWNLOAD_SERVICE 中 获取 ， 它 
的 具体 使 用 过 程 分 为 三 步 : 构建 下 载 请 求 、 进 行 下 载 操 作 、 查 询 下 载 进度 ， 详 细 说 明 如 下 。 


1. 构建 下 载 请 求 
要 想 使 用 下 载 功能 ， 首 先 得 构建 一 个 下 载 请 求 ， 说 明 从 哪里 下 载 、 下 载 参数 是 什么 、 下 载 的 
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文件 保存 到 哪里 等 。 这 个 下 载 请 求 便 是 DownloadManager 的 内 部 类 Request， 该 类 的 常用 方法 说 明 


如 下 。 


构造 函数 : 指定 从 哪个 网 络 地 址 下 载 文件 。 
SetAllowedNetworkTypes: 指定 允许 进行 下 载 的 网 络 类 型 。 允 许 下 载 的 网 络 类 型 的 取 值 说 明 见 
表 10-1， 若 同时 允许 多 种 网 络 类 型 ， 则 可 使 用 位 运算 符 “or” 把 多 种 网 络 类 型 拼接 起 来 。 


表 10-1 ”下 载 任务 允许 网 络 类 型 的 取 值 说 明 


DownloadManager.Request 类 的 允许 网 络 类 型 说 明 





NETWORK WIFI | WIFI 网 络 





NETWORK MOBILE | 数据 连接 网 络 





NETWORK_BLUETOOTH 蓝牙 网 络 


© 0 0 0 0 9 


setDestinationInExternalFilesDir: 设置 下 载 文 件 在 本 地 的 保存 路 径 。 如 果 指 定 目 录 已 存在 同名 
文件 ， 系 统 就 会 将 新 下 载 的 文件 重 命名 ， 即 在 文件 名 末尾 添加 “-1”“-2” 之 类 的 序号 。 
addRequestHeader: 给 HTTP 请 求 添加 头 部 参数 。 

setMimeType: 设置 下 载 文件 的 媒体 类 型 。 一 般 无 须 设置 ， 默 认 是 服务 器 返回 的 媒体 类 型 。 
setTitle: 设置 通知 栏 上 的 消息 标题 。 若 不 设置 ， 则 默认 标题 是 下 载 的 文件 名 。 

setDescription: 设置 通知 栏 上 的 消息 描述 。 若 不 设置 ， 则 默认 显示 系统 估算 的 下 载 剩余 时 间 。 
setVisibleInDownloadsUi: 设置 是 否 显示 在 系统 的 下 载 页 面 上 。 

setNotificationVisibility: 设置 通知 栏 的 下 载 任 务 可 见 类 型 。 可 见 类 型 的 取 值 说 明 见 表 10-2。 


表 10-2 下 载 任务 的 通知 可 见 类 型 取 值 说 明 











DownloadManager.Request 类 的 通知 可 见 类 型 说 阴 

VISIBILITY_HIDDEN 隐藏 

VISIBILITY_VISIBLE 下 载 时 可 见 〈 下 载 完成 后 消失 ) 
VISIBILITY_VISIBLE_NOTIFY_COMPLETED 下 载 进行 时 与 完成 后 都 可 见 
VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION | 只 有 下 载 完成 后 可 见 


2. 进行 下 载 操 作 
构建 完 下 载 请 求 才能 进行 下 载 的 相关 操作 。 下 面 是 DownloadManager 的 下 载 相关 方法 。 


enqueue: 将 下 载 请 求 加 入 任务 队列 中 ， 排 队 等 待 下 载 。 该 方法 返回 本 次 下 载 任务 的 编号 。 
remove: 取消 指定 编号 的 下 载 任务 。 

restartDownload: 重新 开始 指定 编号 的 下 载 任务 。 

openDownloadedFile: 打开 下 载 完 成 的 文件 。 

getMimeTypeForDownloadedFile: 获取 已 下 载 文件 的 媒体 类 型 。 

query: 根据 查询 请 求 获取 符合 条 件 的 结果 集 游标 。 
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3. 查询 下 载 进度 

虽然 下 载 进度 可 在 通知 栏 上 查看 ， 但 是 有 时 App 自身 也 想 了 解 当 前 的 下 载 进 度 ， 那 要 调用 下 
载 管 理 器 的 query 方法 。 该 方法 的 输入 参数 是 一 个 Query 对 象 , 返回 结果 集 的 Cursor 游标 , 这 里 的 
Cursor 用 法 与 SQLite 里 的 Cursor 是 一 样 的 ， 具 体 可 参考 第 8 章 的 “8.2.1 数据 库 帮 助 器 
SQLiteOpenHelper”。 

下 面 是 Query 类 的 常用 方法 说 明 。 
setFilterById: 根据 编号 来 过 滤 下 载 任务 。 
setFilterByStatus: 根据 状态 来 过 滤 下 载 任务 。 
setOnlyIncludeVisibleInDownloadsUi: 是 否 只 包含 在 系统 下 载 页 面 上 的 可 见 任务 。 
orderBy: 结果 集 按照 指定 字段 排序 。 


设置 完 查 询 请 求 ， 即 可 调用 DownloadManager 对 象 的 query 方法 ， 获 得 结果 集 的 游标 对 象 。 
该 游标 中 包含 下 载 任务 的 完整 字段 信息 ， 其 中 主要 下 载 字段 的 取 值 说 明 见 表 10-3。 


表 10-3 下 载 字段 的 取 值 说 明 








DownloadManager 类 的 下 载 字段 说 明 

COLUMN LOCAL FILENAME 下 载 文件 的 本 地 保存 路 径 〈 已 废弃 ) 
COLUMN _ LOCAL URI 下 载 文件 的 本 地 保存 路 径 〈 正 常 使 用 ) 
COLUMN_MEDIA_TYPE 下 载 文件 的 媒体 类 型 
COLUMN_TOTAL SIZE BYTES 下 载 文 件 的 总 大 小 

COLUMN_BYTES DOWNLOADED SO FAR 已 下 载 文件 的 大 小 

COLUMN _STATUS 下 载 状态 ， 取 值 说 明 见 表 10-4 


表 10-4 下 载 状 态 的 取 值 说 明 














DownloadManager 类 的 下 载 状态 说 明 
STATUS_PENDING 挂 起 ， 即 正在 等 待 
STATUS_RUNNING 运行 中 
STATUS_PAUSED 暂停 
STATUS_SUCCESSFUL 成 功 
STATUS_FAILED 失败 


注意 表 10-3 中 的 下 载 字 段 ， 因 为 Android 7.0 之 后 增强 了 文件 访问 权限 ， 造 成 字段 
DownloadManager.COLUMN_LOCAL _FILENAME 被 废弃 ， 所 以 车 在 7.0 及 以 上 版 本 的 手机 访问 该 
字段 ， 则 会 触发 异常 java.lang.SecurityException。 此 时 ， 要 想 获 取 下 载 任务 对 应 的 文件 路 径 ， 只 能 
通过 字段 DownloadManager.COLUMN LOCAL URI 来 得 到 。 

另外 ， 系 统 的 下 载 服务 还 提供 了 三 种 下 载 事件 ， 开 发 者 可 通过 监听 对 应 的 广播 消息 ， 从 而 进 
行 相应 的 处 理 。 这 三 种 下 载 事件 的 处 理 过 程 说 明 如 下 。 


1. 下 载 完成 事件 

在 下 载 完成 时 ,系统 会 发 出 名 称 为 DownloadManager.ACTION_DOWNLOAD _ COMPLETE (其 值 
为 字符 串 “android.intent.action.DOWNLOAD COMPLETE”) 的 广播 ， 因 此 可 注册 一 个 该 广播 的 
接收 器 ， 用 来 判断 当前 任务 是 否 已 下 载 完毕 ， 并 进行 后 续 的 业务 处 理 。 


2. 下 载 进行 时 的 通知 栏 点 击 事件 

在 下 载 过程 中 ， 一 旦 用 户 点 击 通 知 栏 上 的 下 载 任务 ， 系 统 就 会 发 出 名 称 为 DownloadManager. 
ACTION NOTIFICATION_ CLICKED (其 值 为 字符 串 “ android.intent.action.DOWNLOAD_ 
NOTIFICATION_CLICKED”) 的 广播 ， 所 以 可 注册 该 广播 的 接收 器 进行 相关 处 理 ， 比 如 跳 转 到 该 
任务 的 下 载 进度 页 面 等 。 


3. 下 载 完成 后 的 通知 栏 点 击 事件 

在 不 同时 刻 点 击 通知 栏 上 的 下 载 任务 会 触发 不 同 的 响应 事件 。 若 在 下 载 未 完成 时 点 击 ， 则 和 触 
发 的 是 系统 广播 DownloadManager.ACTION_NOTIFICATION_CLICKED; 若 在 下 载 完 成 后 点 击 ， 
则 触发 的 是 系统 Intent.ACTION_VIEW 〈 即 浏览 行为 ) 。 对 于 文件 的 浏览 行为 ， 系 统 会 根据 媒体 类 
型 自动 寻找 对 应 App 来 打开 文件 。 因 此 ,开发 者 若 要 控制 此 时 的 点 击 行为 ， 可 以 调用 Request 对 象 
的 setMimeType 方法 设置 媒体 类 型 ， 这 样 Android 就 会 按照 这 个 类 型 打开 相应 的 App。 

下 面 是 利用 DownloadManager 下 载 APK 安装 包 的 Kotlin 代码 片段 , 此 时 将 下 载 进度 显示 在 通 
知 栏 上 : 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity download apk) 
Download.tv apk result = findViewById<TextView>(R.id.tv apk result) 
tv_spinner.text = apkNames[0] 
tv_spinner.setOnClickListener { 
selector (" 请 选择 要 下 载 的 安装 包 "， apkNames) { i -> 
tv_spinner.text = apkNames[i] 
toast ("${apkNames[i]} 正 在 下 载 ， 详 情 见 通知 栏 ") 
// 声 明 下 载 任务 的 请 求 对 象 
val down = Request (Uri.parse (apkUrls[i])) 
// 指 定 通知 栏 上 的 标题 文本 
down.setTitle("SfapkNames [i]} 下 载 信 息 ") 
// 指 定 通知 栏 上 的 描述 文本 
down .setDescription ("${apkNames [i] } 安 装 包 正在 下 载 ") 
// 手 机 连 上 移动 网 络 或 者 连 上 WIFI 时 均 可 进行 下 载 操作 
down.setAllowedNetworkTypes (Request .NETWORK MOBILE or 
Request .NETWORK WIFI) 
// 指 定 下 载 通知 栏 在 下 载 中 与 完成 后 都 可 见 


down.setNotificationVisibility (Request .VISIBILITY VISIBLE NOTIFY COMPLETED) 
// 指 定 显示 在 系统 的 下 载 页面 上 
down.setVisibleInDownloadsUi (true) 


// 指 定 下 载 文件 在 本 地 的 保存 路 径 
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down.setDestinationInExternalFilesDir(this， 
Environment .DIRECTORY DOWNLOADS, "$i.apk") 
// 把 下 载 请 求 添加 到 下 载 队列 中 
// 这 里 利用 扩展 属性 实现 了 自动 获取 下 载 管理 器 实例 
// 有 关 扩 展 属性 的 介绍 参见 第 9 章 的 “9.5.2 开始 热身 :震动 器 Vibrator” 


downloadId = downloader.enqueue (down) 


// 接收 下 载 完成 事件 
class DownloadCompleteReceiver : BroadcastReceiver() { 
override fun onReceive(context: Context, intent: Intent) { 
if (intent.action == DownloadManager.ACTION DOWNLOAD COMPLETE && 
Download.tv apk result != null) { 
// 获 取 下 载 任务 的 编号 
val downId = intent.getLongExtra 
(DownloadManager .EXTRA_ DOWNLOAD _ID, -1) 
Download.tv apk result?.visibility = View.VISIBLE 
Download.tv apk result?.text = "${DateUtil.getFormatTime()} 编 
号 ${downId} 的 下 载 任务 已 完成 " 
直 


// 接收 下 载 通知 栏 的 点 击 事件 ， 在 下 载 过 程 中 有 效 ， 下 载 完 成 后 失效 
class NotificationClickReceiver : BroadcastReceiver() { 
override fun onReceive(context: Context, intent: Intent) { 
if (intent.action == DownloadManager.ACTION NOTIFICATION CLICKED && 
Download.tv apk result != null) { 
// 获 取 下 载 任务 的 编号 数组 
val downIds = intent.getLongArrayExtra 
(DownloadManager .EXTRA NOTIFICATION CLICK DOWNLOAD IDS) 
for (downId in downIds) { 
// 只 处 理 当前 下 载 任务 的 点 击 事件 
if (downId == downloadId) { 
Download.tv apk result?.text = 
"${DateUtil.getFormatTime () } 编号 ${downId} 的 下 载 进 度 条 被 点 击 了 一 下 " 


companion object Download { 
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// 因 为 DownloadCompleteReceiver 和 NotificationClickReceiver 是 嵌 套 类 
// 赂 套 类 只 能 操作 类 的 静态 属性 ， 所 以 把 tv_apk_result 和 downloadId 放 在 伴生 对 象 里 面 
var tv apk result: TextView? = null 
Private var downloadId: Long = 0 
站 


注意 到 上 述 的 Kotlin 代码 有 接收 两 类 下 载 事件 ， 所 以 要 在 AndroidManifest.xml 中 注册 对 应 广 
播 的 接收 器 ， 有 具体 注册 信息 如 下 所 示 : 


<!-- 注册 下 载 完 成 事件 的 广播 接收 器 --> 
<receiver android:name= 
".DownloadApkActivity$DownloadCompleteReceiver"> 
<intent-filter> 
<action android:name="android.intent .action.DOWNLOAD COMPLETE" /> 
</intent-filter> 
</receiver> 
<!-- 注册 下 载 通 知 栏 点 击 事件 的 广播 接收 器 --> 
<receiver android:name= 
".DownloadApkActivity$NotificationClickReceiver"> 
<intent-filter> 
<action android:name="android.intent.action. 
DOWNLOAD NOTIFICATION CLICKED" /> 
</intent-filter> 
</receiver> 


APK 文件 下 载 的 通知 栏 效果 如 图 10-14 和 图 10-15 所 示 , 其 中 图 10-14 所 示 为 下 载 进行 中 的 通 
知 栏 界 面 ， 图 10-15 所 示 为 下 载 完成 后 的 通知 栏 界 面 。 


酷 狗 音乐 下 载 信息 





图 10-14 下载 进行 中 的 通知 栏 界面 图 10-15 下载 完 成 后 的 通知 栏 界面 





10.3.2” 自 定义 文本 进度 圈 





10.3.1 小 节 把 下 载 进度 显示 到 通知 栏 上 ， 此 时 进度 通知 由 系统 自动 计算 。 但 是 在 更 多 情况 下 ， 
用 户 希望 在 当前 界面 就 能 看 到 文件 的 实时 下 载 进度 ,而 不 是 还 要 过 一 会 儿 就 下 拉 通 知 栏 耿 有松。 于 是 
便 要 求 由 App 自身 去 查询 当前 文件 的 下 载 进度 ， 并 把 进度 描述 显示 到 界面 的 合适 控件 上 。 这 里 涉 
及 两 项 技术 细节 ， 其 一 为 轮 询 文件 的 下 载 进度 ， 该 功能 参见 上 一 小 节 提 到 的 第 三 个 步骤 “3. 查询 
下 载 进度 ”; 其 二 为 描述 进度 的 合适 控件 ， 该 控件 可 考虑 采用 前 面 “10.1.2 进度 对 话 框 
ProgressDialog ”小 节 提 到 的 水 平 进度 对 话 框 。 不 过 与 水 平 的 长 条 进度 相 比 ，App 使 用 圆圈 进度 更 
加 常见 ， 可 是 ProgressBar 的 圆圈 样式 无 法 设 定 具 体 的 进度 值 ， 所 以 若 要 采用 圆圈 进度 ， 则 只 好 完 
全 据 弃 ProgressBar， 从 头 实现 自 定义 的 圆圈 进度 控件 。 

结合 第 9 章 的 自 定义 视图 技术 ， 可 将 圆圈 进度 控件 分 解 为 三 个 绘图 单元 : 首先 绘制 整个 灰色 
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于 环 作为 背景 ; 然后 绘制 绿色 的 圆 弧 作为 前 景 ， 圆 弧 的 角度 由 进度 数值 决定 ,进度 越 大 则 圆 弧 对 应 
的 角度 也 越 大 ， 最 后 在 圆圈 中 央 〈 即 圆心 附近 ) 绘制 进度 文本 ， 例 如 “50%”。 按 照 以 上 三 个 绘图 
单元 的 划分 ， 下 面 给 出 自 定义 文本 进度 圈 的 Kotlin 实现 代码 例子 : 

// 自 定义 视图 要 在 类 名 后 面 增 加 “eJvmoverloads constructor”， 因 为 布局 文件 中 的 自 定义 视图 
必须 兼容 Java 

class TextProgressCircle @JvmOverloads constructor (Private val mContext: 
Context, attr: AttributeSet? = null) : View(mContext，attr) { 
Private val paintBack: Paint = Paint() 








品 























Private val paintFore: Paint = Paint() 
Private val paintText: Paint = Paint() 
Private var lineWwidth = 10 

Private var lineColor = Color .GREEN 
Private var mTextSize = 50.0f 

Private lateinit var mRect: RectF 


Private var mProgress = 0 


hh i 
// 初 始 化 背景 画笔 的 相关 属性 
paintBack.isAntiAlias = true 
paintBack.color = Color.LTGRAY 
paintBack.strokeWidth = lineWidth.toFloat() 
paintBack.style = Style.STROKE 
// 初 始 化 前 景 画笔 的 相关 属性 
paintFore.isAntiAlias = true 
paintFore.color = lineColor 
paintFore.strokeWidth = lineWidth.toFloat() 
paintFore.style = Style.STROKE 
// 初 始 化 文本 画笔 的 相关 属性 
paintText .isAntiAlias = true 
PaintText .color = Color.BLUE 
PaintText.textSize = mTextSize 


// 重 写 onDraw 绘图 函数 ， 绘 制 圆圈 背景 、 圆 圈 前 景 以 及 中 央 的 进度 文本 


override fun onDraw(canvas: Canvas) { 





super .onDraw (canvas) 


val width = measuredWidth // 获 得 当前 视图 的 丈量 宽度 

val height = measuredHeight // 获 得 当前 视图 的 丈量 高 度 

i£ (width <= 0 | height <= 0) { 

return 

} 

val diameter = Math.min(width, height) 

mRect = RectF(((width - diameter) /2 + lineWidth) .toFloat(), ((height 
- diameter) /2 + linewidth) .toFloat(), 
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((width + diameter) / 2 - lineWidth) .toFloat(), ((height + 

diameter) / 2 - lineWwidth) .toFloat()) 

// 绘 制 进度 圆圈 的 背景 ， 背 景 是 完整 的 圆 环 (360 度 绘制 ) 

Canvas.drawArc (mRect, 0f, 360f, false, paintBack) 

// 绘 制 进度 圆圈 的 前 景 ， 前 景 是 实际 进度 占 360 度 的 百分比 

canvas.drawArc (mRect, 0f, (mProgress * 360 / 100).toFloat(), false, 
paintFore) 

val text = "${mProgress.tostring()}%" 

val rect = Rect() 

// 获 得 进度 文本 的 矩形 边界 

paintText .getTextBounds (text, 0, text.length, rect) 

val x = getWidth() / 2 - rect.centerX() 


val y = getHeight() / 2 - rect.centerY() 
// 把 文本 内 容 绘制 在 进度 圆圈 的 圆心 位 置 


canvas.drawText (text, x.toFloat(), y.toFloat(), paintText) 


// 设 置 进 度数 值 以 及 进度 文本 的 文字 大 小 
fun setProgress (progress: Int, textSize: Float) { 
mProgress = progress 
if (textSize > 0) { 
mTextSize = textSize 
paintText.textSize = mTextSize 
} 
invalidate() 


// 设 置 进 度 圆圈 的 线 宽 与 颜色 
fun setProgressStyle(line width: Int, line color: Int) { 
if (line width > 0) { 
lineWidth = line width 
paintFore.strokeWidth = lineWidth.toFloat() 
} 
if (line color > 0) { 
lineColor = line color 
paintFore.color = lineColor 
1 
invalidate() 


} 


然后 在 测试 页 面 添 加 上 述 的 文字 进度 圈 控 件 ,运行 之 后 的 显示 效果 如 图 10-16 和 图 10-17 所 示 ， 
其 中 图 10-16 展示 进度 为 30% 时 的 进度 圈 界 面 ， 图 10-17 展示 进度 为 70% 时 的 进度 圈 界 面 。 
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network 





图 10-16 进度 为 30% 的 文本 圈 效 果 图 10-17 进度 为 70% 的 文本 圈 效 果 


10.3.3 ”在 页 面 上 动态 显示 下 载 进度 


现在 有 了 10.3.2 小 节 的 自 定义 文字 进度 圈 做 铺垫， 就 能 把 轮 询 到 的 实时 下 载 进度 显示 为 进度 
圆 弧 。 举 个 图 片 下 载 的 例子 ， 先 在 页 面 上 预 留待 下 载 图 片 的 位 置 ， 然 后 在 尚未 下 载 完成 的 时 候 ， 原 
图 片 位 置 展示 包含 下 载 进度 的 文字 进度 圈 ， 等 到 下 载 任务 完成 的 时 候 ， 图 片 位 置 关 闭 文字 进度 圈 ， 
改 为 展示 已 下 载 的 图 片 界面 。 

下 面 是 在 页 面 上 展示 图 片 下 载 进度 的 Kotlin 代码 片段 : 


override fun onCreate (savedInstanceState: Bundle?) { 





Super .onCreate (savedInstanceState) 
setContentView(R.layout.activity_download_ image) 
tv_spinner.text = imageNames [0] 
tv_spinner.setOnClickListener { 
selector (" 请 选择 要 下 载 的 图 片 "， imageNames) { i -> 
tv_spinner.text = imageNames [il] 
tv_spinner.isEnabled = false 
iv image url.setImageDrawable (null) 
tpc_progress.setProgress (0, 100f) 
tpc_progress.visibility = View.VISIBLE 
// 声 明 下 载 任务 的 请 求 对 象 
val down = Request (Uri.parse (imageUrls [il)) 
// 手 机 连 上 移动 网 络 或 者 连 上 WIFI 时 均 可 进行 下 载 操作 
down.setAllowedNetworkTypes (Request .NETWORK MOBILE or 
Request .NETWORK WIFI) 
// 隐 藏 下 载 通知 栏 
down.setNotificationVisibility (Request .VISIBILITY HIDDEN) 
// 指 定 不 在 系统 的 下 载 页 面 显示 
down.setVisibleInDownloadsUi (false) 
// 指 定 下 载 文 件 在 本 地 的 保存 路 径 
down .setDestinationInExternalFilesDir( 
this, Environment.DIRECTORY DCIM, "$i.jpg") 
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// 把 下 载 请 求 添加 到 下 载 队列 中 

// 这 里 利用 扩展 属性 实现 了 自动 获取 下 载 管理 器 实例 

// 有 关 扩 展 属性 的 介绍 参见 第 9 章 的 “9.5.2 开始 热身 : 震动 器 Vibrator” 
downloadId = downloader .enqueue (down) 

// 启 动 下 载 进度 的 刷新 任务 

handler.PostDelayed (mRefresh，100) 


Private val handler = Handler() 
Private val mRefresh = object : Runnable { 
override fun run() { 
var bFinish = false 
val down query = Query() 
// 根 据 编 号 来 过 滤 下 载 任务 
down query.setFilterById (downloadId) 
// 根据 查询 请 求 获 取 符 合 条 件 的 结果 集 游标 
val cursor = downloader.query (down_query) 
while (cursor.moveToNext()) { 
// 获 取 下 载 文件 的 uri 路 径 
val uriIdx = cursor.getColumnIndex 
(DownloadManager .COLUMN LOCAL URI) 
// 获 取 文 件 的 媒体 类 型 
val mediaTypeIdx = cursor.getColumnIndex 
(DownloadManager .COLUMN MEDIA TYPE) 
// 获 取 文 件 的 总 大 小 
val totalSizeIdx = cursor.getColumnIndex 
(DownloadManager .COLUMN _ TOTAL SIZE BYTES) 
// 获 取 已 下 载 的 文件 大 小 
val nowSizeIdx = 
cursor.getColumnIndex (DownloadManager .COLUMN BYTES DOWNLOADED SO_FAR) 
// 获 取 文件 的 下 载 状态 
val statusIdx = cursor.getColumnIndex 
(DownloadManager .COLUMN STATUS) 
// 计 算 当 前 的 下 载 进 度 百分比 
val progress = (100 * cursor.getLong (nowSizeIdx) / 
cursor.getLong (totalSizeIdx)) .toInt() 
if (cursor .getString (uriIdx) == null) { 
break 
} 
// 设 置 文本 进度 圈 的 当前 进度 
tpc progress.setProgress (progress, 100f) 
imagePath = cursor.getString (uriIdx) 
tv_image_result .text = "文件 路 径 : ${cursor.getString (uriIdx)}\n"+ 
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"媒体 类 型 : $S{fcursor .getString (mediaTypeIdx) }\n" + 
"文件 总 大 小 : ${cursor.getLong (totalSizeIdx)}\n" + 
"已 下 载 大 小 : ${cursor.getLong (nowSizeIdx)}\n" + 
"下 载 进 度 : $progress%%\n" + 
"下 载 状态 : ${statusMap[cursor.getInt (statusIdx)]}\n" 

// 下 载 进度 达到 100$， 表 示 下 载 完成 

if (progress >= 100) { 

bFinish = true 


} 
cursor.close() 
// 尚 未 完成 下 载 ， 继 续 轮 询 下 载 进度 
if (!bFinish) { 
handler.postDelayed (this, 100) 
} else { 
tv_ spinner.isEnabled = true 
// 下 载 完毕 ， 隐 藏 圆圈 进度 ， 改 为 显示 下 载 好 的 图 片 
tpc_progress.visibility = View.INVISIBLE 
iv image url.setImageURI (Uri.parse (imagePath)) 


companion object { 
// 下 载 状态 类 型 与 中 文 名 称 的 映射 关系 定义 
Private val statusMap = mapOf( 
Pair (DownloadManager .STATUS PENDING," 挂 起 ")， 
Pair (DownloadManager .STATUS_ RUNNING, "运行 中 ")， 
Pair (DownloadManager .STATUS_PAUSED, bh 
Pair (DownloadManager.STRTUS_SUCCESSFUL， "成 功 ") ， 
Pair (DownloadManager.STRTUS_FRILED，" 失 败 ") ) 
上 


上 述 Kotlin 代码 指定 了 隐藏 通知 栏 上 的 下 载 进度 ， 也 就 是 将 通知 的 可 见 类 型 设置 为 
VISIBILITY_HIDDEN， 此 时 需要 在 AndroidManifest.xml 中 加 入 对 应 权限 ， 有 具体 的 权限 配置 如 下 所 
示 《 含 网 络 访问 权限 ) : 

<!-- 互联 网 --> 

<uses-permission android:name="android.permission.INTERNET" /> 

<!-- 下 载 时 不 提示 通知 栏 --> 
<uses-permission 
android:name="android.permission.DOWNLOAD WITHOUT NOTIFICATION" /> 


在 页 面 上 动态 展示 图 片 下 载 进度 的 效果 如 图 10-18 和 图 10-19 所 示 , 进度 形式 采用 10.3.2 小 节 
介绍 的 文字 进度 圈 ， 在 下 载 过 程 中 显示 带 百分比 文字 的 进度 圆圈 ， 下 载 完成 后 显示 已 下 载 的 图 片 。 
其 中 ， 图 10-18 所 示 为 刚 开始 下 载 的 界面 ， 此 时 进度 是 5%， 并且 采用 进度 圆圈 占 位 ; 图 10-19 所 
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示 为 下 载 完毕 的 界面 ， 此 时 占 位 用 的 进度 圆圈 消失 ， 取 而 代 之 的 是 下 载 到 本 地 的 图 片 。 


network network 


5% 


文件 路 径 : file:///storage/emulated/0/Android/data/ 
com.example.network/files/DCIM/4-1 jpg 
媒体 类 型 : image/jpeg 


进度 : 5%% 
下 载 状态 : 运行 中 





图 10-18 刚 开始 下 载 图 片 时 的 界面 图 10-19 图 片 下 载 完成 后 的 界面 
10.4 ”ContentProvider 内 容 提供 


ContentProvider 号 称 是 Android 四 大 组 件 之 一 〈 其 他 三 个 是 活动 Activity、 广 播 Broadcast、 服 
务 Service) ， 主 要 用 于 在 不 同 的 App 之 间 共 享 数 据 。 虽 然 ContentProvider 是 四 大 组 件 之 一 ， 但 其 
内 部 又 分 为 三 个 内 容 组 件 ， 分 别 是 内 容 提供 器 ContentProvider、 内 容 解析 器 ContentResolver、 内 容 
观察 器 ContentObserver。 本 节 就 对 这 三 种 内 容 组 件 进行 详细 的 介绍 。 





10.4.1 内 容 提供 器 ContentProvider 


ContentProvider 为 App 存 取 内 部 数据 提供 了 统一 的 外 部 接口 ， 它 让 不 同 的 应 用 之 间 得 以 共享 
数据 。 像 开发 者 熟知 的 SQLite， 操 作 的 是 应 用 自身 的 内 部 数据 库 ， 文件 的 上 传 和 下 载 操 作 的 是 后 
端 服 务 器 的 外 部 文件 ， 而 ContentProvider 操作 本 设备 其 他 应 用 的 内 部 数据 ， 是 一 种 中 间 层 次 的 数 
据 存储 形式 ， 即 调用 者 位 于 手机 内 部 ， 却 位 于 当前 App 外 部 。 

实际 编码 中 ，ContentProvider 只 是 一 个 服务 端的 数据 存 取 接 口 , 开发 者 需要 在 其 基础 上 实现 一 
个 具体 类 ， 并 重 写 以 下 相关 的 数据 库 管理 方法 。 

@ ”onCreate: 创建 数据 库 并 获得 数据 库 连 接 。 

@ query: 查询 数据 。 

@ insert: 插入 数据 。 
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@ update: 更 新 数据 。 
edelete: 删除 数据 。 
egetType: 获取 数据 类 型 。 


这 些 方法 看 起 来 是 不 是 很 像 SQLite? 没 错 ，ContentProvider 作为 中 间 的 接口 ， 本 身 并 不 直接 
保存 数据 ， 而 是 通过 SQLiteOpenHelper 与 SQLiteDatabase 间接 操作 底层 的 SQLite。 所 以 要 想 使 用 
ContentProvider， 首 先 得 实现 SQLite 的 数据 表 帮 助 器 ， 再 由 ContentProvider 封装 对 外 的 接口 。 

下 面 是 使 用 ContentProvider 提供 用 户 信息 对 外 接口 的 Kotlin 代码 例子 : 


class UserInfoProvider : ContentProvider() { 
lateinit var userDB: UserDBHelper 


// 删 除数 据 
override fun delete(uri: Uri, selection: String?, selectionArgs: 
Array<String>?): Int { 
var count = 0 
if (uriMatcher.match(uri) == USER INFO) { 
count = userDB.delete(selection, selectionArgs) 
1 
return count 


} 


// 插 入 数据 
override fun insert(uri: Uri, values: ContentValues?): Uri? { 
var newUri = uri 
if (uriMatcher.match (uri) == USER INFO) { 
// 向 指定 的 表 插 入 数据 ， 得 到 返回 的 Id 
val rowId = userDB.insert (values) 
if (rowId > 0) { // 判断 插入 是 否 执行 成 功 
// 如 果 添 加 成 功 ， 就 利用 新 添加 的 Id 和 生成 的 新 地 址 
newUri = ContentUris.withAppendedId 
(UserInfoContent .CONTENT URI, rowId) 
// 通知 监听 器 ， 数 据 已 经 改变 


context .contentResolver.notifyCchange (newUri, null) 


} 


return newUri 


// 创 建 ContentProvider 时 调用 的 回调 函数 

override fun onCreate(): Boolean { 
userDB = UserDBHelper.getInstance (context, 1) 
return false 
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// 查 询 数据 库 
override fun query(uri: Uri, projection: Array<String>?, selection: 
String?, 
selectionArgs: Array<String>?, sortOrder: String?): 
Cursor? { 
Var cursor: Cursor? = null 
if (uriMatcher.match(uri) == USER INFO) { 
// 执行 查询 
Cursor = userDB.query (projection, selection, selectionArgs, 
sortOrder) 
// 设置 监听 
cursor? .setNotificationUri (context.contentResolver, uri) 
} 


return cursor 


// 获 取 数 据 访问 类 型 ， 暂 未 实现 
override fun getType (uri: Uri): String? { 
throw UnsupportedOperationException("Not yet implemented" 


// 更 新 数据 ， 暂 未 实现 


override fun update (uri: Uri, values: ContentValues?, selection: String?, 


selectionArgs: Array<String>?): Int { 
throw UnsupportedOperationException("Not yet implemented" 


companion object { 
val USER INFO = 1 
val uriMatcher = UriMatcher (UriMatcher .NO MATCH) 
// 伴 生 对 象 的 初始 化 操作 
init { 
uriMatcher.addURI (UserInfoContent .AUTHORITIES, "“/user", 
USER_INFO) 


} 


既然 内 容 提 供 器 是 四 大 组 件 之 一 ， 就 得 在 AndroidManifest.xml 中 注册 它 的 定义 ， 并 对 其 开放 


外 部 访问 的 权限 ， 注 册 代 码 示 例如 下 : 
<!-- 注册 用 户 信息 的 内 容 提 供 器 --> 
<provider 
android:name=" .Provider.UserInfoProvider" 
android:authorities= 
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"com.example.network.provider.UserIinfoProvider" 
android:enabled="true" 
android:exported="true" /> 


provider 注册 完毕 ， 如 此 便 完 成 了 服务 端 App 的 封装 工作 ， 接 下 来 即 可 由 其 他 App 进行 数据 
存 取 。 


10.4.2 内容 解 析 器 ContentResolver 


10.4.1 小 节 提 到 了 利用 ContentProvider 实现 服务 端 App 的 数据 封装 ， 如 果 其 他 App 想 访问 服 
务 端 App 的 内 部 数据 ， 就 要 通过 内 容 解 析 器 ContentResolver 来 访问 。 内 容 解 析 器 是 外 部 App 操作 
服务 端 数据 的 工具 ， 相 对 应 的 内 容 提 供 器 是 服务 端的 数据 接口 。 若 要 获取 ContentResolver 对 象 ， 
则 可 在 Activity 代码 中 调用 getContentResolver 方法 ,现在 Kotlin 中 可 直接 使 用 属性 ContentResolver 
取代 方法 getContentResolver()。 

ContentResolver 提供 的 方法 与 ContentProvider 是 一 一 对 应 的 , 比如 query、insert、update、delete、 
getType 等 方法 ， 连 方法 的 参数 类 型 都 一 模 一 样 。 其 中 ， 最 常用 的 是 query 方法 ， 调 用 该 方法 返回 
一 个 游标 Cursor 对 象 ， 这 个 游标 与 SQLite 的 游标 是 同样 的 ， 想 必 读 者 早已 用 得 炉火纯青 。 

下 面 是 query 方法 的 具体 参数 说 明 。 
uri: Uri 类 型 ， 可 以 理解 为 本 次 操作 的 数据 表 路 径 。 
projection: 字符 串 数 组 类 型 ， 指 定 将 要 查询 的 字段 名 称 列表 。 
selection: 字符 串 类 型 ， 指 定 查询 条 件 。 
selectionArgs: 字符 串 数 组 类 型 ， 指 定 查询 条 件 中 的 参数 取 值 列表 。 
sortOrder: 字符 串 类 型 ， 指 定 排序 条 件 。 


针对 10.4.1 小 节 UserInfoProvider 提供 的 数据 接口 ， 下 面 是 使 用 ContentResolver 在 外 部 App 
添加 用 户 信息 的 Kotlin 代码 例子 : 


Private fun addUser (resolver: ContentResolver, user: UserData) { 














© 0 0 0 9。 


val name = ContentValues () 

name.put ("name", user.name) 

name.put ("age", user.age) 

name.put ("height", user.height) 

name.put ("weight", user.weight) 

name.put ("married", false) 

name.put ("update time", DateUtil.getFormatTime()) 

//UserInfoContent .CONTENT_URI 指向 的 字符 串 就 是 provider 在 
AndroidManifest .xml 里 的 android:authorities 属性 值 

resolver.insert (UserInfoContent .CONTENT URI, name) 

} 


下 面 是 使 用 ContentResolver 在 客户 端 查询 所 有 用 户 信息 的 代码 例子 : 


Private fun readAllUser (resolver: ContentResolver): String { 
val userArray = ArrayList<UserData>() 
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val cursor = resolver.query (UserIinfoContent .CONTENT URI, null, null, 


null, null) 
while (cursor.moveToNext()) { 
val user = UserData() 
user.name = cursor.getString(cursor.getColumnIndex 
(UserInfoContent .USER NAME)) 
user.age = cursor.getInt (cursor.getColumnIndex 


(UserInfoContent .USER AGE)) 
user.height = cursor.getInt (cursor.getColumnIndex 
(UserInfoContent .USER HEIGHT)) .toLong() 
user.weight = cursor.getFloat (cursor.getColumnIndex 
(UserInfoContent .USER WEIGHT)) 
userArray.add (user) 
} 


cursor.close() 


Var result = "" 


for (user in userArray) { 
result = "$result$ {user.name} 年 龄 ${user .age} 身高 ${user .height} 


体重 $ {user.weight}\n" 


return result 
利用 内 容 解 析 器 添加 用 户 信息 的 效果 如 图 10-20 所 示 ， 一 开始 服务 端的 用 户 表 不 存在 用 户 记 
录 ， 外 部 App 通过 ContentResolver 添加 一 条 记录 后 ， 服 务 端的 用 户 记 录 数 返回 1。 用 户 信息 的 查 
询 明 细 如 图 10-21 所 示 ， 点 击 页 面 上 的 用 户 记录 数量 ， 弹 出 一 个 对 话 框 ， 提 示 当 前 找到 的 所 有 用 户 
的 明细 数据 ， 包 括 姓 名 、 年 龄 、 身 高 、 体 重 等 信息 。 

















EE 当前 共 找到 1 位 用 户 信息 
25 一 
165 阿 四 年 龄 25 身高 165 体重 50.0 
|50 
添加 用 户 信息 
当前 共 找到 1 位 用 户 信息 
图 10-20 添加 一 条 用 户 信息 的 界面 图 10-21 用 户 信息 明细 的 查询 结果 


实际 开发 中 ， 普 通 App 很 少 会 开放 数据 接口 给 其 他 应 用 访问 ， 所 以 作为 服务 端 接口 的 
ContentProvider 反而 基本 用 不 到 。 内 容 组 件 能 够 派 上 用 场 的 情况 往往 是 App 想 要 访问 系统 应 用 的 
通信 数据 ， 比 如 查看 联系 人 人、 短信、 通话 记录 以 及 对 这 些 通信 信息 进行 增删 改 查 。 

下 面 是 使 用 ContentResolver 添加 联系 人 信息 的 Kotlin 代码 片段 ， 此 时 访问 的 数据 来 源 变 成 了 
系统 自 带 的 联系 人 资源 库 “content:/com.android.contacts/”: 
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fun addContacts (resolver: ContentResolver, contact: Contact) 1{ 

val raw uri = Uri.parse("content://com.android.contacts/ 
raw contacts") 

val values = ContentValues () 

// 添加 一 条 联系 人 的 主 记录 ， 并 返回 唯一 的 联系 人 编号 

val contactId = ContentUris.pParseId(resolver.insert (raw uri, values)) 

val uri = Uri.parse("content://com.android.contacts/data") 

// 添加 联系 人 姓名 要 根据 前 面 获取 的 id 号 ? 

val name = ContentValues () 

name.put("raw contact id", contactId) 

name.put ("mimetype", "vnd.android.cursor.item/name") 

name.put ("data2", contact.name) 

resolver.insert (uri, name) 

// 添加 联系 人 的 手机 号 码 

val phone = ContentValues () 

Phone.put ("raw contact id", contactId) 

Phone.put ("mimetype", "vnd.android.cursor.item/phone v2") 

Phone.put ("data2", "2") 

Phone.put ("datal", contact.phone) 

resolver.insert (uri, phone) 

// 添加 联系 人 的 电子 邮箱 

Val email = ContentValues () 

email.put ("raw contact id", contactId) 

email.put ("mimetype", "vnd.android.cursor.item/email v2") 

email.put ("data2", "2") 

email.put ("datal", contact.email) 

resolver.insert (uri, email) 


|， 


注意 到 上 述 代码 用 了 4 条 insert 语句 , 但 业务 上 只 添加 了 一 个 联系 人 信息 。 这 样 处 理 有 个 问题 ， 
就 是 4 个 insert 操作 不 在 同一 个 事务 中 ， 要 是 中 间 某 步 insert 操作 失败 ， 那 么 之 前 插入 成 功 的 记录 
无 法 自动 回 滚 ， 从 而 产生 垃圾 数据 。 

为 了 避免 这 种 情况 的 发 生 , Android 又 提供 了 内 容 操作 器 ContentProviderOperation 进行 批量 数 
据 的 处 理 。 内 容 操作 器 在 一 个 请 求 中 封装 多 条 记录 的 修改 动作 ， 然 后 一 次 性 提交 给 服务 端 ， 这 就 实 
现 了 在 一 个 事务 中 完成 多 条 数据 的 更 新 操作 。 即 使 某 条 记录 处 理 失败 ，ContentProviderOperation 也 
能 根据 事务 一 致 性 原则 ， 自 动 回 滚 本 事务 已 经 执行 的 修改 操作 。 

下 面 是 使 用 ContentProviderOperation 批量 添加 联系 人 信息 的 Kotlin 代码 片段 : 


fun addFullContacts (resolver: ContentResolver, contact: Contact) { 
val raw uri = Uri.parse("content://com.android.contacts/ 
raw_contacts") 
val uri = Uri.parse("content://com.android.contacts/data") 
// 依次 封装 联系 人 主 记录 、 联 系 人 姓名 、 手 机 号 码 、 电 子 邮箱 的 操作 行为 
Val op main = ContentProviderOperation 
.newInsert (raw uri) .withValue ("account name", null) .build() 
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Val op name = ContentProviderOperation 
.newInsert (uri) .withValueBackReference ("raw contact id", 0) 
.withValue ("mimetype", "vnd.android.cursor.item/name") 
.withValue ("data2", contact.name) .build() 

Val op phone = ContentProviderOperation 
.newInsert (uri) .withValueBackReference ("raw contact id", 0) 
.withValue ("mimetype", "vnd.android.cursor.item/phone v2") 
.withValue ("data2", "2") .withValue ("datal", contact.phone) 
.build() 

val op email = ContentProviderOperation 
.newInsert (uri) .withValueBackReference ("raw contact id", 0) 
.withValue ("mimetype", "vnd.android.cursor.item/email v2") 
.withValue ("data2", "2") .withValue ("datal", contact.email) 
-build() 

// 把 以 上 4 个 操作 行为 组 成 行为 队列 ， 并 一 次 性 处 理解 决 该 行为 队列 

val operations = mutableListOf (op main, op name, op phone, op email) 

resolver.applyBatch ("com.android.contacts", operations as 

ArrayList<ContentProviderOperation>) 
| 


采取 批量 方式 添加 联系 人 信息 的 效果 如 图 10-22 和 图 10-23 所 示 ， 其 中 图 10-22 所 示 为 添加 之 
前 的 截图 ， 此 时 联系 人 个 数 为 174 位 ; 图 10-23 所 示 为 添加 成 功 之 后 的 截图 ， 此 时 联系 人 个 数 为 
175 位 。 























阿 四 阿 四 
1596023**** 1596023x**** 
[aaa@163.com | aaa@163.com 
添加 联系 人 添加 联系 人 
当前 共 找 到 174 位 联系 人 当前 共 找 到 175 位 联系 人 
图 10-22 添加 联系 人 之 前 的 截图 图 10-23 添加 联系 人 之 后 的 截图 


10.4.3 ”内 容 观察 器 ContentObserver 


ContentResolver 获取 外 部 数据 采用 的 是 主动 查询 方式 ， 有 去 查 就 有 数据 ， 没 去 查 就 没 数据 。 
但 有 时 App 不 但 要 获取 以 往 的 数据 ， 还 要 实时 获取 新 增 的 数据 ， 最 常见 的 业务 场景 便 是 短信 验证 
码 。 电 商 App 经 常 在 用 户 注册 或 者 付款 时 下 发 验证 码 短信 ， 为 了 帮 用 户 省 事 ，App 通常 会 监控 手 
机 刚 收 到 的 验证 码 数字 ， 并 自动 填 入 验证 码 输入 框 。 这 时 就 用 到 了 内 容 观察 器 ContentObserver， 
它 给 目标 内 容 注 册 一 个 观察 器 , 然后 目标 内 容 的 数据 一 旦 发 生变 化 , 就 马上 触发 观察 器 规定 好 的 动 
作 ， 从 而 执行 开发 者 预先 定义 的 代码 。 
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内 容 观察 器 的 用 法 与 内 容 提 供 器 类 似 ， 也 要 从 ContentObserver 派生 出 一 个 观察 器 类 ， 然 后 通 
过 ContentResolver 对 象 调用 相应 的 方法 注册 或 注销 观察 器 。ContentResolver 与 观察 器 有 关 的 方法 
说 明 如 下 。 


® IegisterContentObserver: 注册 内 容 观察 器 。 
@ ”unregisterContentObserver: 注销 内 容 观察 器 。 
@ notifyChange: 通知 内 容 观察 器 发 生 了 数据 变化 。 


为 了 让 读者 能 够 更 好 地 理解 ， 还 是 举 个 实际 应 用 的 例子 。 很 多 手机 安全 App 都 具备 流量 校准 的 
功能 ， 只 要 把 特定 格式 的 短信 发 送 给 移动 运营 商 ， 就 会 收 到 运营 商 下 发 的 流量 校准 短信 ， 通 过 解析 
这 个 流量 短信 ， 即 可 获取 详细 的 用 户 流量 数据 ， 包 括 月 流量 额度 、 已 使 用 流量 、 未 使 用 流量 等 信息 。 

以 中 国 移动 的 手机 号 码 为 例 ， 发 送 短信 内 容 “18” 到 客服 号 码 10086， 不 一 会 儿 便 会 收 到 10086 
发 来 的 流量 结果 短信 。 下 面 是 利用 ContentObserver 实现 流量 校准 功能 的 Kotlin 页 面 代码 : 


class ContentObserverActivity : AppCompatActivity() { 
Private var mObserver: SmsGetObserver? = null 


override fun onCreate (savedInstanceState: Bundle?) { 
Super .onCreate (savedInstanceState) 
setContentView(R.layout.activity content observer) 
Observer.tv check flow = findViewById<TextView>(R.id.tv check flow) 
tv_check flow.setOnClickListener { 
alert (mCheckResult，" 收 到 流量 校准 短信 ") { 
positiveButton ("确定 ") {} 
}.show() 
} 
btn check flow.setOnClickListener { 
var dialog = indeterminateProgressDialog ("正在 进行 流量 校准 "，" 请 稍 候 ") 
dialog.show() 
// 查 询 数据 流量 ， 移 动 号 码 的 查询 方式 为 发 送 短信 内 容 “18” 给 “10086” 
// 电 信和 联通 号 码 的 短信 查询 方式 请 咨询 当地 运营 商 客服 热线 
sendSsmsAuto("10086", "18") 
Handler () .postDelayed({ 
if (dialog.isShowing == true) { 
dialog.dismiss() 
}}, 5000) 
} 
mSmsUri = Uri.parse("content://sms") 
msmsColumn = arrayOf ("address", "body", "date") 
mObserver = SmsGetObserver (this, Handler()) 
// 注 册 短信 接收 的 内 容 观 察 器 
contentResolver.registerContentObserver (mSmsUri!!, true, mObserver!!) 
} 


override fun onDestroy() { 


// 注 销 短信 接收 的 内 容 观 察 器 
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contentResolver.unregisterContentObserver (mObserver!!) 
super.onDestroy () 
下 


// 短 信 发 送 广播 ， 如 需 处 理 可 注册 该 事件 的 BroadcastReceiver 


Private val SENT_ SMS ACTION = "com.example.network.SENT_SMS_RCTION" 


// 短 信 接 收 广播 ， 如 需 处 理 可 注册 该 事件 的 BroadcastReceiver 
Private val DELIVERED SMS ACTION = "com.example.network. 
DELIVERED_ SMS ACTION™" 


fun sendSmsRAuto (PhoneNumber: String, message: String) { 
// 声 明 短信 发 送 的 广播 意图 
val sentIntent = Intent (SENT SMS ACTION) 
sentIntent .putExtra("phone", phoneNumber) 
SentIntent .putExtra("message", message) 


val sentPI = PendingIntent .getBroadcast (this, 0, sentIintent, 


PendingIntent .FLAG UPDATE CURRENT) 
// 声 明 短信 接收 的 广播 意图 
val deliverIntent = Intent (DELIVERED SMS ACTION) 
deliverIntent.PutExtra("phone"，PhoneNumber) 
deliverIntent .PutExtra("message"，message) 
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val deliverPI = PendingIntent .getBroadcast (this，1，deliverIntent， 


PendingIntent .FLRAG_ UPDATE CURRENT) 
// 要 确保 打开 发 送 短信 的 完全 权限 ， 不 是 那 种 还 需 提示 的 不 完整 权限 
val smsManager = SmsManager.getDefault() 
smsManager .sendTextMessage (phoneNumber, null, message, 
deliverPI) 
YE 


// 定 义 一 个 短信 观察 器 的 媒 套 类 


Private class SmsGetObserver (Private val mContext: Context, 


Handler) : ContentObserver (handler) { 


override fun onChange(selfChange: Boolean) { 
Var sender = "" 
Var content = "" 
// 查 询 收 件 箱 中 来 自 10086 的 最 近 短信 
val selection = "address="10086' and 
date>${System.currentTimeMillis()-1000*60*60}" 
val cursor = mContext.contentResolver.query!( 


msmsUri!!, mSmsColumn, selection, null, " date desc") 


while (cursor.moveToNext()) { 
sender = cursor.getString(0) 
content = cursor.getString(1) 
break 

1 

cursor.close () 
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mCheckResult = "发 送 号 码 : $sender\n 短信 内 容 : $content" 

// 将 解析 后 的 短信 内 容 显 示 到 界面 上 

Observer.tv_check flow!!.text = "流量 校准 结果 如 下 : \n\t" + 
"总 流量 为 : $S{findFlow (content， "总 流量 为 "， "MB") } \n\t"” + 
"已 使 用 ，${findFlow (content，" 已 使 用 "， "MB") }\nNt" + 
"剩余 : $S{findFlow(content，" 剩 余 "， "MB") }" 

super.onChange (selfChange) 


| 


companion object Observer { 
Private var tv check _ flow: TextView? = null 
Private Var mCheckResult: String = "" 
Private Var mSmsUri: Uri? = null 
Private var mSmsColumn: Array<String>? = null 
// 在 伴生 对 和 象 中 定义 解析 短信 内 容 的 方法 
Private fun findFlow(sms: String, begin: String, end: String): String { 
val begin pos = sms.indexOf (begin) 
if (begin pos < 0) { 
return "未 获取 " 
} 
val sub_ sms = sms.substring (begin pos) 
val end pos = sub sms.indexof (end) 
return if (end pos < 0) { 
"未 获取 " 


} else sub sms.substring (begin.length, end pos + end.length) 


} 


根据 运营 商 短信 进行 流量 校准 的 效果 如 图 10-24 和 图 10-25 所 示 ， 其 中 图 10-24 所 示 为 用 户 实 
际 收 到 的 短信 内 容 ， 图 10-25 所 示 为 App 监视 短信 并 解析 完成 的 流量 数据 页 面 。 
22:47 
您 好 ! 您 上 月 结 转 至 本 月 的 国内 流量 
为 600MB。 截止 2017 年 11 月 21 日 
22 时 47 分 ， 您 办 理 的 套餐 内 含 移动 数 
据 总 流量 为 1GB176MB， 已 使 用 
388MB,， 剩 余 812MB ( 其 中 您 已 使 
用 388MB， 副 号 
1 ( 159 轩 | ) 已 使 用 
0MB ) 。 其 中 国内 流量 剩余 














812MB ( 含 国内 结 转 流量 进行 流量 校准 
212MB ) 。 免 费 赠送 “ 任 我 看 ” 卡 1 流量 校准 结果 如 下 ， 

张 ， 一 天 一 元 500m， 不 用 不 花 钱 ， 总 流量 为 : 1GB176MB 

还 送 首 月 月 租 : http://dx.10086.cn/ 已 使 用 : 388MB 

忆 kwap 【 中 国 移动 ] 剩余 : 812MB 








图 10-24 用 户 收 到 的 短信 内 容 10-25 App 解析 后 的 流量 数据 
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10.5 “实战 项 目 : 电 商 App 的 自动 升级 


都 说 酒 香 不 怕 巷 子 深 ， 又 说 养 在 深 畦 人 未 识 ， 这 两 句 话 看 似 矛 盾 ， 其 实 指 的 是 同一 个 含义 ， 
即 美好 的 事物 要 想 办 法 让 大 众 了 解 才 会 闻名 。 无 论 是 香 际 十 里 , 还 是 抛 头 露面 , 目的 都 是 开展 营销 ， 
也 就 是 俗话 说 的 做 广告 。 开 发 电 商 App 也 是 如 此 ， 要 想 让 大 家 知道 这 里 的 商品 质量 过 硬 、 价 格 公 
道 ， 势 必 经 常 举 办 各 种 促销 活动 ， 比 如 一 年 一 度 的 618、 双 十 一 等 。 既 然 频 繁 搞活 动 ， 就 得 进行 技 
术 支 撑 ， 隔 三 岔 五 对 App 升级 一 下 ， 增 加 几 个 新 功能 ， 修 复 一 些 老 BUG 等 。 这 个 App 升级 功能 
便 是 本 童 末尾 的 实战 项 目 “ 电 商 App 的 自动 升级 ”， 这 个 自动 升级 到 底 用 到 了 哪些 技术 ? 下面 就 
来 看 看 该 项 目的 分 析 与 设计 。 


10.5.1 需求 描述 


要 说 安装 App, 可 能 有 的 小 伙伴 觉得 那 还 不 简单 , 直接 找 个 应 用 商店 搜索 App 名 称 不 就 行 了 ? 
但 初次 安装 与 安装 后 升级 不 是 一 个 概念 , 如 果 升级 也 靠 用 户 手动 到 应 用 商店 搜索 并 安装 ， 那 就 “图 
样 图 森 破 ”了 。 贴 心 的 做 法 是 在 App 内 部 提供 在 线 更 新 的 功能 ， 这 个 在 线 更 新 又 分 为 两 种 形式 ， 
一 种 是 由 用 户 手工 选择 应 用 菜单 上 的 “检查 更 新 ”， 另 一 种 是 App 启动 后 自行 判断 服务 器 上 是 否 
有 更 高 版 本 的 安装 包 。“ 检 查 更 新 ”的 菜单 项 位 置 在 每 个 App 内 部 都 不 一 样 ，App 自动 进行 升级 
判断 则 后 台 服 务 并 没有 对 应 的 界面 ， 所 以 在 线 更 新 的 效果 图 暂且 按照 图 10-26 所 示 的 样子 , 效果 图 
上 有 两 个 按钮 ， 其 中 “不 请 求 接口 直接 弹 窗 ” 按 钮 模拟 了 用 户 点 击 “ 检 查 更 新 ”菜单 的 动作 ，“ 请 
求 服务 端 接口 再 弹 窗 ”按钮 模拟 的 则 是 App 自动 检查 升级 的 功能 。 

无 论 是 手动 更 新 还 是 自动 更 新 ， 结 果 都 要 调用 后 端 服务 器 的 版 本 更 新 接口 ， 根 据 服务 器 的 应 
答 报 文 判断 是 否 需 要 升级 。 如果 服务 器 返回 有 更 新 的 安装 包 , App 界面 就 弹 窗 提示 用 户 要 不 要 在 线 
升级 ， 提 示 窗 如 图 10-27 所 示 。 注 意 这 里 有 种 特殊 的 情况 ， 倘 若 App 扫描 设备 发 现存 储 卡 上 已 经 
存在 新 版 本 的 APK 安装 包 ， 则 提示 用 户 本 地 已 经 有 了 新 包 ， 无 须 耗费 流量 即 可 进行 升级 ， 此 时 的 
提示 窗 如 图 10-28 所 示 。 





人 eeSpge 








商场 ”超市 百货 便利 店 。 地摊 升级 提醒 升级 提 寻 
系统 检测 到 爱 奇 艺 的 最 新 版 本 号 是 系统 检测 到 爱 奇 艺 的 最 新 版 本 号 是 
8.8.5， 快 去 在 线 升级 吧 。 8.8.5, 本 次 升级 无 须 流量 。 
i 以 后 再 说 以 后 再 说 确定 升级 
图 10-26 商城 首页 模拟 两 种 图 10-27 需要 下 载 安装 包 的 图 10-28 无 须 下 载 安装 包 的 
升级 动作 提示 窗 提示 窗 


对 于 手机 存储 卡 未 找到 新 版 本 APK 的 情况 ， 只 要 用 户 在 提示 框 中 选择 “确定 升级 ”，App 就 
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要 一 边 下 载 APK 文件 ， 一 边 弹出 进度 对 话 框 ， 包 含 下 载 进度 的 对 话 框 如 图 10-29 所 示 。APK 安装 
包 下 载 完毕 ， 或 者 App 发 现 手机 原来 已 有 对 应 版 本 的 安装 包 ， 接 着 用 户 确认 升级 操作 之 后 ，App 
应 当 继续 APK 的 安装 动作 ， 安 装 期 间 仍 需 弹 窗 提示 正在 安装 ， 安 装 提示 对 话 框 如 图 10-30 所 示 。 

等 待 App 完成 新 版 本 的 升级 ， 回 到 升级 前 的 App 界面 ， 然 后 弹出 升级 完毕 的 提示 对 话 框 ， 如 
图 10-31 所 示 ， 至 此 方才 结束 App 的 自动 升级 历程 。 


请 稍 候 请 稍 候 
升级 完毕 





正在 下 载 爱 奇 艺 的 安装 包 正在 安装 爱 奇 艺 的 最 新 版 本 


爱 奇 艺 的 8.8.5 版 本 升级 完成 。 


44/100 


我 知道 了 





图 10-29 下载 过 程 中 的 进度 对 话 框 图 10-30 ”安装 过 程 中 的 进度 对 话 框 ”图 10-31 升级 完毕 的 提示 对 话 框 


另外 ， 上 面 几 个 提示 对 话 框 中 的 消息 文本 需要 高 亮 显示 升级 后 的 最 新 版 本 号 ， 从 而 更 好 地 提 
醒 用 户 正 在 升级 的 是 哪个 版 本 。 


10.5.2 ”开始 热身 : 可 变 字符 串 SpannableString 


10.5.1 小 节 的 需求 描述 说 到 提示 框 中 的 最 新 版 本 要 用 高 亮 文字 显示 , 可 是 文本 视图 只 提供 了 统 
一 的 文本 样式 设置 方法 ， 比 如 通过 setTextColor 方法 设置 文本 颜色 ,通过 setTextSize 方法 设置 文本 
大 小 ， 还 可 以 通过 setTextAppearance 方法 设置 文本 风格 (包括 颜色 、 大 小 、 对 齐 方式 等 )。 一旦 
调用 了 这 些 方法 , 文本 内 容 就 会 显示 同样 的 颜色 、 同 样 的 大 小 或 者 同样 的 风格 , 根本 没 法 让 内 部 某 
些 文字 单独 高 亮 显 示 。 因 此 ， 为 了 解决 分 段 文本 展示 不 同样 式 的 需求 ，Android 提供 了 可 变 字符 串 
SpannableString， 通 过 该 工具 实现 对 文本 样式 的 分 段 显 示 。 

可 变 字 符 串 的 原理 是 给 指定 位 置 的 文本 赋予 对 应 的 样式 ， 从 而 告知 系统 这 段 文本 的 显示 方式 。 
具体 到 Kotlin 编码 上 ， 主 要 有 三 个 步 又， 说 明 如 下 。 


C301 从 指定 文本 字符 串 构 造 一 个 SpannableString 对 象 。 

人 ED 调用 SpannableString 对 象 的 setSpan 方法 设置 指定 文本 段 的 显示 风格 。 该 方法 的 第 一 个 
参数 为 风格 样式 ， 第 二 个 参数 为 文本 段 的 起 始 位 置 ， 第 三 个 参数 为 文本 段 的 终止 位 置 ， 第 四 个 参数 为 
风格 的 范围 标志 (一 般 设 置 为 Spanned.SPAN_EXCLUSIVE_EXCLUSIVE) 。 

人 3 把 处 理 好 的 SpannableString 对 象 赋值 给 文本 视图 的 text 属性 。 注 意 text 字段 的 类 型 并 非 
String， 而 是 CharSequence， 因 此 凡是 实现 了 CharSequence 接口 的 类 ， 其 对 象 都 允许 赋值 给 text 字段 。 
字符 串 String 类 当然 有 实现 CharSequence， 同 样 可 变 字符 串 SpannableString 类 也 实现 了 该 接口 ， 故 而 
它们 的 实例 均 为 合法 的 text 参数 。 

由 此 可 见 , 运用 可 变 字符 串 的 关键 是 第 二 步 ， 不 过 第 二 步 的 setSpan 方法 每 次 也 只 能 单独 设置 
一 处 的 文字 样式 ， 倘 若 原 字符 串 有 多 处 文本 需要 定制 文字 样式 ， 那 还 得 多 次 调用 setSpan 方法 ， 这 
样 盘算 依然 不 太 经 济 。 好 在 强大 的 Anko 库 又 封装 了 一 个 扩展 函数 buildSpanned， 只 要 在 该 函数 内 
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部 调用 形 如 “append( 待 定制 样式 的 文本 , 定制 后 的 风格 样式 )” 的 代码 ， 即 可 返回 自动 拼接 后 的 多 
彩 文本 串 。 
下 面 是 通过 buildSpanned 函数 连续 构建 可 变 字符 串 的 Kotlin 代码 例子 : 








val str: Spanned = buildSpanned { 
append ("为 "，StyleSpan (TYpeface.BOLD) ) // 文 字 字体 使 用 粗 体 
append ("人 民 "，RelativeSizeSpan (1.5f)) // 文 字 大 小 增 大 到 1.5 倍 大 
append ("服务 "，ForegroundColorSpan (Color.RED) ) // 文 字 颜 色 使 用 红色 
append ("是 谁 "，BackgroundColorSpan (Color.GREEN) ) // 背 景色 使 用 绿色 
append (" 提 出 来 的 "，UnderlineSpan () ) // 文 字 下 方 增加 下 划 线 

} 


上 面 的 Kotlin 眼 辐 着 还 算 整 齐 ， 然 而 仅仅 为 了 表示 粗 体 就 得 书写 完整 的 风格 声明 代码 
“StyleSpan(Typeface.BOLD) ”着 实 不 够 干脆 。 所 以 Anko 索性 在 这 里 快刀 斩 乱 麻 ， 又 把 
“StyleSpan(Typeface.BOLD)” 简 化 成 了 “Bold”， 其 他 几 个 风格 声明 也 陆续 予以 缩写 。 于 是 最 终 

简化 后 的 Kotlin 代码 如 下 所 示 : 


val str: Spanned = buildSpanned { 
append ("为 "，Bold) // 文 字 字体 使 用 粗 体 
append ("人 民 "，RelativeSizeSpan (1.5f)) // 文 字 大 小 增 大 到 1.5 倍 大 
append ("服务 "，foregroundColor (Color .RED) ) // 文 字 颜色 使 用 红色 
append ("是 谁 "，backgroundColor (Color .GREEN) ) // 背 景色 使 用 绿色 
append ("提出 来 的 "，Underline) // 文 字 下 方 增加 下 划 线 

} 


以 上 构建 可 变 字符 串 用 到 的 风格 样式 只 是 沧海 一 票 ， 完 整 的 风格 样式 定义 在 android.text.style 
包 中 ， 总 共有 30 多 个 类 型 ， 当 然 常用 的 没 这 么 多 ， 笔 者 整理 了 几 个 常用 的 风格 样式 ， 结 合 Anko 
库 的 简化 写法 ， 有 具体 说 明 见 表 10-5。 


表 10-5 常用 的 显示 风格 列表 与 Anko 库 的 简化 写法 





























可 变 字符 串 的 显示 风格 类 Anko 库 的 简化 写法 说 明 
RelativeSizeSpan 无 设置 文字 的 相对 大 小 
StyleSpan(Typeface BOLD) Bold 设置 粗 体 文字 
StyleSpan(Typeface.Italic) Italic 设置 斜体 文字 
ForegroundColorSpan foregroundColor 设置 文字 的 颜色 
BackgroundColorSpan backgroundColor 设置 文字 的 背景 色 
UnderlineSpan Underline 给 文字 加 上 下 划 线 
StrikethroughSpan Strikethrough 给 文字 加 上 删除 线 
ImageSpan 无 把 文字 替换 为 图 片 





接着 对 可 变 字符 串 分 别 运用 不 同 的 文字 样式 ， 看 看 到 底 都 有 哪些 风格 的 显示 效果 。 下 面 是 使 
用 可 变 字符 串 设置 文字 样式 的 Kotlin 代码 例子 : 
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class SpannableActivity : AppCompatActivity() { 


private val spannables = listof(" 增 大 字号 "，" 加 粗 字 体 "， "前 景 红色 "， 


"背景 绿色 "， "下 划 线 "， "表情 图 片 "， "Rnko 自 定义 ") 


Private val text = "为 人 民 服 务 " 

Private val key = "人 民 " 

Private var beginPos = text.indexOf (key) 
Private var endPos = beginPos + key.length 


override fun onCreate (savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout .activity spannable) 
tv_spannable.text = text 
tv_ spinner.text = spannables[0] 
tv_spinner.setOnClickListener { 


selector (" 请 选择 可 变 字符 串 样式 "， spannables) { i -> 

tv_spinner.text = spannables[i] 

val spanText = SpannableString (text) 

// 对 这 段 文本 运用 指定 的 风格 样式 

SpanText .setSpan (when (i) { 

0 -> RelativeSizeSpan(1.5f) // 文 字 大 小 增 大 到 1.5 倍 大 

-> StyleSpan (Typeface.BOLD) // 文 字 字 体 使 用 粗 体 
-> ForegroundColorSpan (Color.RED) // 文 字 颜 色 使 用 红色 
-> BackgroundColorSpan (Color .GREEN) // 背 景色 使 用 绿色 
-> UnderlineSpan () // 文 字 下 方 增加 下 划 线 
else -> ImageSpan (this@SpannableActivity, R.drawable.people) 


心 w N 


// 把 文字 替换 为 图 片 


由 于 





}, beginPos, endPos, Spanned.SPAN EXCLUSIVE EXCLUSIVE) 
tv_spannable.text = spanText 
if (i >= 6) { 
// 使 用 Anko 库 的 buildspanned 函数 连续 构建 可 变 字符 串 
tv_spannable.text = buildSpanned { 
append ("为 "，Bold) 
append (" 人 民 "，RelativeSizeSpan(1.5f)) 
append (" 服 务 "， foregroundColor (Color .RED) ) 
append (" 是 谁 "，backgroundColor (Color .GREEN) ) 
append ("提出 来 的 "，Underline) 


F 上 面 的 Kotlin 代码 用 到 了 Anko 库 的 扩展 函数 (包括 buildSpanned、append 等 ) ， 所 以 务 


必 在 代码 头 部 加 入 下 面 一 行 导入 语句 : 


import org.jetbrains.anko.* 

另外 ， 要 修改 模块 的 build.gradle， 在 dependencies 节点 中 补充 下 述 的 anko-common 包 编 译 
配置 : 

compile "org.jetbrains.anko:anko-common: $anko version" 

可 变 字符 串 所 呈现 的 不 同 风格 效果 如 图 10-32 一 图 10-38 所 示 ， 其 中 图 10-32 所 示 为 加 大 字体 
后 的 效果 ， 图 10-33 所 示 为 加 粗 字体 后 的 效果 ， 图 10-34 所 示 为 修改 文字 颜色 后 的 效果 ， 图 10-35 
所 示 为 修改 文字 背景 后 的 效果 ， 图 10-36 所 示 为 增加 下 画 线 后 的 效果 ， 图 10-37 所 示 为 把 文字 替换 
成 图 片 后 的 效果 ， 图 10-38 所 示 为 采用 Anko 函数 混合 多 种 样式 后 的 效果 。 


network 


可 变 字符 串 样式 : 增 大 字号 可 变 字符 串 样式 : 加 粗 字 体 


为 人 民 服 务 为 人 民 服 务 
图 10-32 ”加 大 字体 的 字符 串 效果 10-33 ”加 粗 字体 的 字符 串 效果 





network 
可 变 字符 串 样式 : 前 景 红 色 | 可 变 字符 串 样式 : 背景 绿色 


为 人 民 服 务 为 网 展 服 务 


图 10-34 ”变更 文字 颜色 的 字符 串 效果 图 10-35 变更 背景 颜色 的 字符 串 效果 








network 
可 变 字符 串 样式 : 下 划 线 


为 人 民 服 务 


network 


可 变 字符 串 样式 : 表情 图 片 





10-36 添加 下 划 线 的 字符 串 效果 


可 变 字符 串 样式 : Anko 自 定义 
为 人 民 服 务 居 提出 来 
的 








图 10-38 采用 Anko 函数 混合 多 种 样式 的 字符 串 效果 


10.5.3 ”控件 设计 


由 于 自动 升级 功能 更 多 是 在 后 台 完 成 的 ， 界 面 上 用 到 的 控件 反而 不 多 ， 因 此 下 面 罗列 的 并 不 
限于 控件 ， 还 包括 后 台 的 处 理 技术 。 
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(1) 提醒 对 话 框 AlertDialog: 用 于 提醒 用 户 是 否 立即 升级 应 用 ， 以 及 升级 完毕 之 后 的 提示 语 。 
(2) 进度 对 话 框 ProgressDialog: 在 下 载 APK 文件 的 时 候 ， 以 及 APK 安装 过 程 中 ， 都 要 显 
示 进 度 对 话 框 。 

(3) 可 变 字符 串 SpannableString: 提示 文本 中 需要 将 最 新 版 本 号 高 亮 显示 ， 这 便 用 到 了 可 变 
字符 串 。 
(4) 多 线程 : App 与 后 端 服务 器 进行 接口 交互 ， 需 要 开启 分 线程 才能 调用 HTTP 接口 。 

(5) 网 络 地 址 URL: Kotlin 对 URL 类 进行 了 扩展 ， 增 加 了 readText 方法 用 于 获取 接口 数据 。 

(6) 移 动 数据 格式 JSON: 后 端 接 口 返回 JSON 格式 的 版 本 升级 信息 字符 串 , 然 后 App 把 JSON 
串 转换 为 数据 类 对 象 。 

(7) 下 载 管理 器 DownloadManager: 用 于 APK 文件 的 下 载 行为 ， 包 括 下 载 进度 的 查询 操作 。 

(8) 应 用 包 管 理 器 PackageManager: 根据 应 用 包 管 理 器 获得 应 用 的 版 本 号 信息 。 


除了 上 面 提 到 的 技术 以 外 ， 也 会 用 到 内 容 解 析 器 ContentResolver， 因 为 需求 提 到 : 如 果 手 机 
内 存 能 找到 最 新 版 本 的 安装 包 ， 那 就 无 须 下 载 直接 安装 即 可 。 若 要 查找 手机 上 的 APK 安装 包 ， 可 
到 媒体 资源 库 中 查询 媒体 类 型 为 “application/vnd.android.package-archive ”的 文件 ， 该 类 型 表示 安 
卓 应 用 的 安装 包 ， 也 就 是 APK 文件 。 
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为 了 方便 读者 更 好 、 更 快 地 使 用 Kotlin 编码 完成 自动 升级 项 目 ， 下 面 列 举 几 个 重要 功能 的 
Kotlin 代码 片段 : 


1. 关于 向 服务 器 请 求 版 本 更 新 信息 
访问 后 端的 HTTP 接口 ， 倘 若 使 用 Java 编码 ， 必 定 又 是 长 篇 大 论 。 采 用 Kotlin 编码 的 瘦身 效 
果 立 笔 见 影 ， 只 要 通过 doAsync+uiThread 组 合 ， 接 口 调用 的 操作 就 变 得 轻描淡写 。 下 面 是 HTTP 
接口 访问 的 Kotlin 代码 例子 : 
btn need request.setOnClickListener { 
val pi = packageManager.getPackageInfo (packageName, 0) 
// 开 启 分 线程 执行 后 端 接口 调用 
doAsync { 
// 从 服务 端 获取 版 本 升级 信息 
val url = 
"$checkUrl?package name=$ {pi.packageName}&version name=$ {pi.versionName}" 
val result = URL(url) .readText () 
// 回 到 主线 程 在 界面 上 弹 窗 提示 待 升 级 的 版 本 
uiThread { checkUpdate (result) } 


} 


既然 是 访问 服务 器 的 接口 ， 表 定 要 有 对 应 的 服务 端 程序 ， 这 个 服务 端 程序 可 见 本 书 源 代码 中 
的 HttpTest 工程 包 。 
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2. 关于 高 亮 显示 一 段 文 本 中 的 指定 文字 
在 已 有 的 文本 中 高 亮 显示 其 中 的 某 些 文字 ， 处 理 起 来 还 有 点 烦琐 ， 首 先 要 找到 指定 文字 在 整 
段 文 本 中 的 位 置 , 再 对 这 些 文字 设置 对 应 的 高 亮 样式 。 鉴 于 高 亮 功能 比较 通用 ,因此 可 以 写 到 工具 
类 里 面 , 不 过 既然 使 用 Kotlin 编码 , 建议 考虑 采取 扩展 函数 的 形式 将 高 亮 处 理 函 数 作为 String 类 的 
一 个 扩展 函数 ， 这 样 用 起 来 更 加 方便 。 
下 面 是 对 String 类 进行 扩展 、 添 加 highlight 高 亮 函数 的 Kotlin 代码 : 
// 字 符 串 中 的 关键 语句 用 指定 样式 高 亮 显示 
fun String.highlight (key: String, style: CharacterStyle): SpannableString { 
val spanText = SpannableString (this) 
val beginPos = this.indexOf (key) 
val endPos = beginPos + key.length 
SpanText .setSpan (style，beginPos，endPos， 
Spanned.SPAN EXCLUSIVE EXCLUSIVE) 
return spanText 


} 
有 了 上 述 的 扩展 函数 定义 ， 外 部 就 能 直接 调用 字符 串 对 象 的 highlight 方法 ， 完 全 无 须 记 忆 工 
具 类 的 名 称 。 具 体 的 Kotlin 调用 代码 如 下 所 示 : 


val spanText = message.highlight (vec.version name, 
ForegroundColorSpan (Color .RED) ) 


同时 不 要 忘 了 在 代码 文件 头 部 添加 下 面 的 一 行 导入 语句 , 表示 此 处 用 到 了 自己 扩展 的 highlight 
方法 : 
import com.example.network.util.highlight 


3. 关于 alert 如 何 显示 可 变 字符 串 的 文本 内 容 

前 面 刚 设置 好 可 变 字符 串 的 文本 内 容 , 不 料 发 现 无 法 利用 alert 方法 显示 该 文本 了 , 怎么 回 事 ? 
这 是 因为 在 Java 编码 中 ，AlertDialog.Builder 的 setTitle 和 setMessage 两 个 方法 的 输入 参数 都 是 
CharSequence， 自 然 允 许 将 可 变 字符 串 对 象 赋值 进去 。 然 而 Anko 库 扩 展 出 来 的 alert 方法 ,message 
和 title 这 两 个 入 参 类 型 却 改 成 String 字符 串 了 ， 使 得 SpannableString 与 String 类 型 不 同 ， 因 此 无 
法 输入 。 

没 想到 还 有 这 样 的 事情 ， 真 叫 “ 攻 城 狮 ” 颜 面 何在 。 不 过 作为 程序 员 可 得 不 豚 艰 难 险阻 ， 逢 山 
开路 、 遇 水 搭桥 , 现在 Anko 库 造 的 alert 桥 过 不 了 , 不 妨 自己 搭 个 自 定义 的 新 桥 , 偷梁换柱 , 把 message 
字段 的 参数 类 型 改 成 CharSequence 就 行 了 。 于 是 改写 后 的 alert 方法 代码 就 变 成 下 面 这 样 了 : 

//Anko 自 带 的 alert 只 支持 String 类 型 的 文本 ， 不 支持 富 文本 的 charSequence 类 型 

// 故 此 处 重 写 alert 方法 ， 使 之 支持 可 变 字符 串 SpannableString 

fun Context.alert( 

message: CharSequence, 
title: String? = null, 
init: (AlertDialogBuilder.() -> Unit)? = null 
) = AlertDialogBuilder (this) .apply { 
if (title != null) title(title) 
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message (message) 
if (init != null) init() 
1 
改写 完毕 ,不 要 忘 了 在 Activity 代码 头 部 添加 下 面 的 一 行 导入 语句 , 表示 本 页 面 用 的 是 自 定义 
的 alert 方 法 : 


import com.example.network.util.alert 


4. 关于 如 何 获 取 手 机 上 的 APK 文件 

前 面 “10.5.3 控件 设计 ”小 节 提 到 ， 利 用 内 容 解析 器 ContentResolver 可 到 资源 库 中 查询 媒体 
类 型 为 “application/vnd.android.package-archive” 的 APK 文件 ， 但 这 只 是 大 概 的 思路 。 因 为 即便 找 
到 了 几 个 APK 文件 ，App 又 如 何 甄别 这 些 APK 都 是 什么 来 头 、 哪 个 APK 文件 才 符 合 当前 应 用 的 
指定 版 本 号 呢 ? 所 以 要 想 逐 个 判定 APK 文件 的 真实 身份 , 还 得 解析 APK 内 部 的 包 信息 , 具体 的 工 
作 则 是 调用 PackageManager 对 象 的 getPackageArchiveInfo 方法 , 该 方法 可 从 指定 的 APK 路 径 获 取 
安装 包 的 详细 数据 ,包括 应 用 的 包 名 、 应 用 的 版 本 号 等 。 有 了 包 名 、 版 本 号 这 些 信息 ，App 方 能 鉴 
定 本 地 是 否 存在 最 新 版 本 的 升级 包 。 

下 面 是 获取 并 校 验 本 设备 上 APK 文件 的 Kotlin 代码 例子 : 


Private fun getLocalPath (vc: VersionCheck) : String { 





var local path = "" 
// 遍 历 本 地 所 有 的 apk 文 件 
val cursor = contentResolver.query (MediaStore.Files.getContentUri 
("external"), 
null, "mime type=\"application/vnd.android.package-archive\"", 
null, null) 
while (cursor.moveToNext()) { 
//TITLE 获取 文件 名 ，DATA 获取 文件 完整 路 径 ，SIZE 获取 文件 大 小 
val path = cursor.getString (cursor.getColumnIndex 
(MediaStore.Files.FileColumns .DATA)) 
// 从 apk 文件 中 解析 得 到 该 安装 包 的 程序 信息 
val pi = packageManager.getPackageArchiveInfo (path, 
PackageManager .GET ACTIVITIES) 
if (pi != null) { 
// 找 到 包 名 与 版 本 号 都 符合 条 件 的 apk 文件 
if (vec.package name==pi.packageName && 
ve.version name==pi.versionName) { 
local path = path 
} 
} 
} 
cursor.close() 
return local path 
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5. 关于 下 载 APK 文件 的 操作 过 程 
如 果 手 机 上 没 找到 符合 条 件 的 安装 包 ， 就 必须 联网 去 服务 器 下 载 最 新 的 APK 文件 。 相 关 文 件 
下 载 的 Kotlin 处 理 代码 如 下 所 示 : 


// 开 始 执行 升级 处 理 。 如 果 本 地 已 有 安装 包 ， 就 直接 进行 操作 ;如 果 不 存在 ， 就 从 网 络 下 载 安装 包 
Private fun startIinstallApp(vc: VersionCheck) { 
apPVc = vc 
// 本 地 路 径 非 空 ， 表 示 存 储 卡 找到 最 新 版 本 的 安装 包 ， 此 时 无 须 下 载 即 可 进行 安装 操作 
if (vc.local path.isNotEmpty()) { 
handler.PostDelayed (mInstall, 100) 
} else { 
// 构 建安 装 包 下 载 地 址 的 请 求 任务 
val down = Request (Uri.parse(vc.download url)) 
down.setAllowedNetworkTypes (Request .NETWORK MOBILE or 
Request .NETWORK WIFI) 
// 隐 藏 通知 栏 上 的 下 载 消息 
down.setNotificationVisibility (Request .VISIBILITY HIDDEN) 
down.setVisibleInDownloadsUi (false) 
// 指 定 下 载 文件 的 保存 路 径 
down .setDestinationInExternalFilesDir(this， 
Environment .DIRECTORY DOWNLOADS, "${vc.package name} .apk") 
// 将 请 求 任务 添加 到 下 载 队列 中 
downloadId = downloader.enqueue (down) 
handler .postDelayed (mRefresh, 100) 
// 弹 出 进度 对 话 框 ， 用 于 展示 下 载 进度 
val message = "正在 下 载 ${appVc.app_name} 的 安装 包 " 
dialog = progressDialog (message, "请 稍 候 ") 
dialog.show() 


10.6 小 结 


本 章 主 要 介绍 了 Kotlin 如 何 进行 网 络 通信 的 编程 实现 ， 包 括 多 线程 相关 技术 的 运用 线程 与 
消息 机 制 、 进 度 对 话 框 的 两 种 形式 、 异 步 任务 的 新 型 写法 ) 、HTTP 接口 的 访问 操作 (JSON 串 的 
手工 解析 与 自动 解析 、HTTP 接口 调用 的 简单 实现 、 获 取 HTTP 图 片 的 简单 实现 ) 、 文 件 下 载 的 相 
关 处 理 〈 下 载 管理 器 的 用 法 、 自 定义 文本 进度 圈 、 在 页 面 上 动态 显示 下 载 进度 ) 以 及 Content 内 容 
组 件 的 数据 存储 和 读 取 《〈 内 容 提供 器 、 内 容 解 析 器 、 内 容 观 察 器 ) 。 最 后 设计 了 一 个 实战 项 目 “ 电 
商 App 的 自动 升级 ”， 在 该 项 目的 Kotlin 编码 中 采用 了 前 面 介 绍 的 部 分 网 络 通信 技术 ， 以 及 通过 
内 容 组 件 自 动 判断 是 否 存在 已 下 载 的 安装 包 ， 另 外 还 介绍 了 Kotlin 对 可 变 字符 串 的 改进 编码 。 

通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 5 种 开发 技能 
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(1) 学 会 使 用 Kotlin 实现 多 线程 任务 的 开发 ， 重 点 掌握 Kotlin 对 线程 、 进 度 对 话 框 、 异 步 任 
务 的 简要 写法 。 

(2) 学 会 使 用 Kotlin 完成 HTTP 接口 的 访问 编码 ， 重 点 掌握 Kotlin 如 何 自动 解析 JSON 串 、 
如 何 便捷 调用 HTTP 接口 、 如 何 快速 获取 HTTP 图 片 。 

(3) 学 会 使 用 Kotlin 进行 文件 下 载 的 相关 操作 ， 重 点 掌握 Kotlin 对 下 载 事件 的 处 理 ， 以 及 
Kotlin 是 怎样 轮 询 下 载 进 度 的 。 

(4) 学 会 使 用 Kotlin 开发 Content 内 容 组 件 的 功能 ， 例 如 封装 数据 的 对 外 接口 ， 以 及 对 开放 
内 容 接 口 的 系统 数据 进行 查询 、 修 改 和 监视 操作 等 。 

(5) 学 会 利用 Kotlin 简化 可 变 字符 串 的 编码 过 程 。 


